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Dear New Owner: 

Welcome to the third computer generation — a generation 
characterized by your need for more powerful/ 

sophisticated tools with fewer complications and less 
cost. This is truly the generation of the 
independent-minded/ highly competent user, 

PROMQUEEN owners have a broad range of backgrounds, 
skills,- and needs. Users that range from gifted teenage 
hobbyists to senior instrument development engineers are 
employing the PROMQUEEN to run music synthesizers, 
industrial processes, robotic devices, to develop 
not-so-standard classroom materials from basic math to 
college physics, and even to vend computer time* 

With this in mind, the material in this manual has been 
arranged at varying levels of technical difficulty, and 
is geared to have you up and running as quickly as 
possible. It is assumed you have a working knowledge of 
BASIC, some background or a desire to build a background 
in assembly language, a good fundamental knowledge of 
computer architecture, numbering systems, and 
terminology, and a preference for creating devices, 
processes, games, whatever — your own way. 

The manual is roughly divided into quarters. The first 
section is for the new user and contains applications 

you can use immediately while you are developing your 
skills. Then comes a full, sit-down tutorial of all the 
Hexkit software capabilities. Next, for the familiar 
user, comes a summary of all commands, routines, and 

procedures covered in the first section. These are 
written to help you find things fast. In the last 

sections, you'll find the technical hardware 
descriptions and advanced information and applications. 
PLEASE READ THIS MANUAL THOROUGHLY ! 

Our user hot line is (617) 283-7719. 
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PROMQUEEM CONTROLS 



NOTE: SOTCHED END OF EPROM MUST FACE UF ! 



ZIP SOCKET 

POWER CONTRO] 

SWITCH 



MIMIC /PROG 

SELECT 
SWITCH 



Vpp ADJUST 
FOR 2716 

Vpp ADJUST 
?OR 2732 



RESET BUTTON 



'RED LED 



3URN/PR0G 
SELECT . 
SWITCH 

/ - 




4 -POSITION BLOCS SELECT 
DIP SWITCH 
L-H. ..5321 



.SOCKET RELEASE HAKDLE 
- r N LATCHED POSITION) 

ZERO INSERTION FORCE 
(2 IF) SOCKET 

9EXKIT 1.0 EPROM 



EPRCM TYPE 
SELECT 
SWITCH 







1*1 Plugging in Tour promqoeen CARTRIDGE the First Time 

These steps along with the opposite diagram will quickly 

acquaint you with the PROMQUEEN controls. 

1) Carefully examine the cartridge* If it appears 
damaged/ return it for exchange. See page 79. 

2) Remove the Hexkit program EPROM from the Sero 
Insertion Force socket* It will lift out easily 
after you have pulled up on the socket release 
handle- Set it on conductive foam. 

3) Make sure the BLOCK select DIP switch is set for 
BLOCK Zr that isr the second rocker switch from 
the left is depressed at the top* Refer to the 
switch numbers embossed on the case, not the ones 
on the switches themselves. Use a dull pointed 
object to set BLOCK 3 and reset the other 3 
blacks. The PROMQUEEN cartridge is now set to 
occupy the range of addresses from decimal 24576 
($6000) to decimal 327 67 (57FFF). Note that you 
can put the PROMQUEEN cartridge into any of the 
four expansion BLOCKS depending on which BLOCK 
SELECT 0IP switch you set. Always avoid setting 
more than one BLOCK at a time* If more than one 
of the rockers is set on at one timer the vie will 
not properly decode addresses. 

4) Set the four toggle switches at the top of the 
cartridge so that they are flipped towards you, 
that is, with the toggle handles perpendicular to 
the top of the case. These settings will be: 

SOCXET=*ON 

B0RN/PR0G=PRGG 

MIMIC/PROG=PROG 
EPROM=2732A 

5) Make sure the VIC is turned off. Plug the 
PROMQUEEN cartridge face up into Vic's expansion 
slot f which is the largest slot on the back of the 
VIC and the only port into which the PROMQUEEN 
will fit- Seat the PRQMqdebn firmly into the 
connector. 
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7) 



8) 



green LED goVout L = SWltCh fc ? MIMIC ' the 

between thlLr"\ n o ert 'i n 3 fT/ Cabl f conne =ted 
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9) The toggle to the eight of the MIMIC/PROG switch 
ia the EPROM select switch. This switch may be 
set to read and program either 2716 or 2732X 
EPROMs* A third type of EPROM r the 27 32A, can be 
read when the switch is in the 27 32 position, but 
it cannot be programmed until you adjust the 
voltage. See page 53. With the switch set for 
2732 BPROMs, all 4096 bytes Of the PROMQOEEN RAM 
can be addressed either by the VIC, when the 
MIWIC/PRCX3 switch is set to PROG r or the external 
computer when the MIMIC/PROG switch is set to 
MIMIC. NOTE; You can also use 27C16 and 27C32 
EPROMS with the PRQMQO"BBN (these are CMOS types) - 
Flip the switch to the 2716 position. This does 
not affect the contents of the PROMQUEEN RAM, but 
does restrict access to only the first 2048 bytes 
of PROMQDEEN RAM by the external computer. No 
indicator lights are affected* This switch 
governs the built-in 21 or 25-volt programming 
voltage power supply, and the pin on the EPROM to 
which the supply is connected* ALWAYS MAKB SURE 
THAT YOO HAVE THIS SWITCH SET FOR THE PROPER EPROM 
TYPE BEFORE YOU ATTEMPT .TO BORN AH EPROM. 
OTHERWISE YOO WILL PROBABLY DAMAGE THE EPRCW WHEN 
YOO ATTEMPT TO BURN IT. (No damage will occur if 
you have the switch mis-set in the normal PROG 
mode]. Flip the EPROM switch back to the 2732 
position. 

10) The upper right toggle has two modes: BURN and 
PROG . When set to BURH f this switch enables you 
to BORN your own program onto an EPROM. The RED 
LED will come on r indicating that programming 
voltage is being supplied to the EPROM socket. 
With no EPROM in the socket, test the BURN switch 
by slipping it away from you- Note that in BURN 
mode you can permanently program EPROMs either 
from BASIC (see page 48) or from Hexkit's BURN 
routine (see pages 15 or 44) . 

A faint buzzing noise made by the DC/DC converter 
inside the cartridge may be audible when the red 
LED is on. This is normal. Notice that the red 
LED will go out, along with the green if you now 
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flip the SOCKET switch to off* or if you flip the 
PROG/MIMIC switch to KIMIC« This is intended to 
inhibit the programing power supply in these 
modes. NEVER 1URN OFF THE PROGRAMMING VOLTAGE 
THIS WAY WHEN YOO ARE BURNING AN EPROM. THE EPROM 
CODLD BE DAMAGED. 

You will not be able to read the contents of the 
PROMQCEEN RAM through the VIC when the PROG/BURN 
switch is set to BORR. 

If the RED LED has been on all along , or if it 
fails to go out if you flip the PROG/BURN switch 
towards you into PROG mode/ the cartridge is 
defective; return it for exchange. 

Flip the PROG/BURN switch towards you into PROG 
raode. Observe that the red LED goes out, and the 
green LED stays on. 



1.2 LOADIBG AHD OPERATING HKXKIT 

to install your Hexkit EPROM, first restore the toggle 
switches to these positions; 

S0CKET»OFP 
BURN/ PROG-PROG 
MIMIC/PROG-PROG 
EPROM=27 32 

a) Unlatch the 2IP CEPROM) socket by pulling up on 
the handle with the greenish knob- 

b> Put your Hexkit EPROM* notched end away from you, 
in the ZIP socket* 

a*********************************************** 

REMEMBER 

Turn OFF the SOCKET switch whenever you 

change EPROMs. 
*****-*******■************************************ 

c] Latch down the 2IP handle and turn on the SOCKET 
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switch. The green LED should come on. 

d) To load Hexkit 1.0 when the cartridge occupies 
BLOCK 3, type: 

SYS29039 <R£TURN> 

The Hexkit program will start to run by itself. 
If it doesn't, turn off the VIC and check the 
BLOCK DIP switch. See page 1, step 3. 



e) you should now be seeing the Main Menu display: 

EDIT HEX A 

BORN EPROM.. B 

SAVE ON DEVICE. ..C 
LOAD FROM DEVICE. D 
V'F¥ SAVE B 

f) For now, type an A to enter the EDIT BSX routine. 

g) Review ; 

1. In BLOCK 3 type SYS29039 <RETURN> to load 
Hexkit and display the Main Menu* 

2. Select the operation you want by typing A, 
B, C f D, or E. (No <RETURN> is needed.) 

3. To get out of an operation and back to the 
Main Menu, type X or series of Xs. 

4. To restore VIC BASIC, type an X to the Main 
Menu* If you go into VIC BASIC from the 
Main Menu, the Menu will not erase, but you 
will see the "ready" message and the 
blinking cursor. 

5* To restore Hexkit (after it has been loaded 
by the SYS command) from VIC 3ASICr type a 

RUN <R£TURN>. 

6. For now, if you wipe out entirely, go back 
to step 1, and reload Hexkit. 
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h) After you have typed an A to EDIT BEX on the Main 
Menu, you will see this display: 

EDIT HEX 
WBERE? - 

i> Type $6000 in Hexadecimal and return. 

EDIT REX 
WHERE? $6000 

*********************************************** 

REMSMBER 

The $ sign tells the computer you are 

entering a Hexadecimal number. 
*********************************************** 

j) You are also able to enter decimal numbered 
addresses (preceded by #) or a MARKER. These are 
explained in the. Bexkit Tutorial (see page 30) • 

k) You should see this display. (NOTE; Memory 
contents may be anything because the memory chips 
turn on with random data,) 



EDIT HEX 



24569 5FP9 5F 

24570 5FPA SF 

24571 5FFB 5F 

24572 5FFC 5F 

24573 5FFD 5F 

24574 SFFE 5F 

24575 5FFF 5F 

24576 6000 QQ 

24577 6001 A2 

24578 6002 00 

24579 6003 FF 
24530 6004 00 
24581 6005 FF 

24532 6006 00 

24533 6007 FF 
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1) 



m> 



n> 



o) 



You are now ready 
first address Cas 
user RAH. 

Look at the line that the blinking cursor is 



to communicate directly with the 
set in BLOCS 3> of the PROMQOEEN 



on: 



2457S m Address in decimal 
6000 = Address in hexadecimal 

00 « One byte (8 bits), the present 
contents of address $6000 in Hex 

You will be using an additional leftmost column 
and a rightmost column (pages 29 and 30J , These 
will be explained in the Hexkit Tutorial. 

Turn the SOCKET switch OFF, release the 2IP socket 

handle, and remove the Hexkit EPROM. Notice that 
Hexkit is still running, because you have loaded 

iLi? fc ^ the VIC *: You could now install another 

SPROM to copy at. (See page 15 for the copy 

procedure.) 

For now try the following: 

Type the little program in hexadecimal code 
exactly as given below, on the VIC keyboard. 
Observe what happens to the display as you do 
this, you don't need $ signs to enter hex code. 

A2 93 8A 20 D2 FF CA EO 21 30 F7 60 

If you make any mistakes, just finish the entry by 

typing any hex digit and back up the display bv 

S^« ng J: *? UJ ? 0r Up key ' Type over to change. 
Move the display up or down by using the cursor 

f Y : ??5 0ic your li3t of he * numbers which must 
start with A2 at 24576 ($$000) . 

The Hexkit Tutorial gives you an INITIATE 
Keystroke command, but for now, you can run your 

SltFT "} r, ? u ? h . BASIC - (This way, you'll know two 
methods of initiating your machine code programs.) 

2XS?^ X (£or the Main Menu! ' * ^o get back to 
BASIC), SYS24576 <RETURN> (to access the decimal 
addreas of your program) , and RUN <REnjRN>. 
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p) You should now be seeing the character set of the 
vie displayed. If, instead, something went wrong, 
or the cursor is lost, you can RESET. Otherwi 
just type RUN <RSTURN> to get back into Sexkit. 



ise 



q) Press the RESET button on the PQ cartridge. This 
gives you the VTC's cold start display. You can 
reload Rexkit as in review step 1 on page 5* or 
you can just restart Hexkit by typing SYS 4112, 
you will be happy to know that your machine code 
programs will remain intact after a RESET. {The 
actual text of BASIC programs will also be 
unaffected but the "pointers" that tell the 
operating system where the BASIC is will be reset. 
eence r BASIC programs will not run after resets.) 
You'll notice that whatever you entered into 
PROMQUEEN RAM will 3till be there* Using the 
RESET to recover from faulty machine code won't 
alter the code. This saves you the tedium of 
storing machine language programs before testing 
them. 

******************** ******* **************************** 

REMEMBER 

you can always get back to the Main Menu 

by typing an X or a series of Xa depending 
on where you are in the program. 

Typing an X to the Main Menu will 
restore you to VIC BASIC. 

Pressing the RESET button gives you a 

clean start* You can get back up from 

EPROM by typing SYS 29039 (if you are in 

BLOCK 3) or SYS 4112 if Hexkit is already 

loaded into VIC RAM. 
********************************** ********************* 

PRCKQOEEN AS VIC 4K EXPANSION 

Here is an easy way to expand your VIC. Turn off the VIC 
and remove the cartridge,, Turn off the BLOCK 3 DIP 
switch, and set ON the BLOCK 1 DIP switch. Plug in the 
cartridge and turn on the VIC. Notice that the "bytes 
free* message now says 7679. You have added the 
PSOMQOEEN rah to the VIC BASIC RAM, and relocated the 
position of screen memory in the VIC address space. You 
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can now write BASIC programs more than twice as long as 
before, or use the PROMQUEEN in BLOCK 1 (address space of 
3192 ($2000) to 16383 ($3FFF) for machine code programs 
and EPROMs. Note that you can put the cartridge into any 
of the 4 VIC expansion blocks just by setting the 
appropriate switch on the BLOCK select DIP switch. 

Hexkit is designed to be loadable to the VIC'S memory 
from any of the 4 expansion blocks into which you can 
place the cartridge. The command to load Hexkit when the 
cartridge is in Block 1 is SYS 12619. Try it and see. 
The funny business you see flash briefly on the screen 
occurs because the load commands always put the screen 
memory back to its usual location in the unexpended VIC. 
PROMQtIEEN addressing is fully explained in the fiexkit 
Tutorial. 



SUMMARY OP HEXKIT LOAD COMMANDS 

BLOCK COMMAND 

1 SYS 12619 

2 SYS 2082 9 

3 SYS 29039 

4 SYS 45441 
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1.3 SAYING HACHME CODE PROGRAMS 

The purpose of this section is to enable you to make vour 

Save, Load and Verify to Device 
Burn EPHOM 

1#3 "L. T ° f AVE aexkit <or your own machine code 
program) on TAPE, follow these steps: 

a) VERT V FY C fjW&Hfc****' USe thS USUal VIC 

llnl lu * in t *?* casset te to where you 
want the tape to be, 

b) SS f °fv ^SlPS', rGm0Ve the PROMQDEEN, and 

reset the DIP Switch to BLOCK 3. (You'll 
know how to save from other blocks after 
you read the Hexkit Tutorial.) 

C) K^^Sr?** 1 ! ? PR0M insta ^ed (notch up) 

S2-S2 ZIF socket ' turn on the Vic and the 

SOCKET switch, type SYS29039 <RETURN>7 

Select Menu option C. The display: 

SAVE ON DEV 
DEV. # - 

Type a l. The display * 

SAVE ON DEV 
DEV, # 1 
FROM - 

f> Sh/ 1001 < re ™m> (starting address of 

Bexkit program code in Hex) 

FROM $1001 TO - 
gJ Type 51DEE <R£TURH> (ending address in Hex) 

FROM SJ.001 TO 510EE 



<3) 



e) 
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h> 



In this case, you are saving the Hexkit 
program directly from the above range of 
addc esses in VIC user RAH. Note that when 
saving any block of code, give the starting' 
address of the code to the PROM? prompt and 
the ending address to the TO prompt* 

To the NAME? prompt, type Hexkit or 
whatever (up to IS^letter) name you wish 
and <EETUHH>. 



i> Pollov the instructions to "Press record 
and play on tape. - When the SAVE is 
complete, the Main Menu returns to the 
screen. (Note that you cannot put an 
end~of-tape marker on tapes through 
Hexkit.) The code will be saved under the 
name you gave it with a reload header 
affixed to the file* 

More technical information and suggestions 
for use of the additional capabilities of 
this routine can be found on page 49. 
Although you cannot save programs to tape 
or disk from BLOCK 5, in any .other block 
you can save directly off the EPRCM or from 
the PROMQUEEN user RAH. 

j> If you have a problem, you will see a VIC 
Kernal error message instead of the ones 
with which you might be more familiar. 
Refer to the "VIC-2C Programmer's Reference 
Manual* page 210 for the list of 10 error 
codes. 

2. TO VERIFY Hexkit (or your machine code program) 
after the save on tape/ follow these steps: 

a) Don't forget to rewind your tape. 

b> Type an £ to the Main Menu. The display: 

V'FY SAVE 
DSV. # - 
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<=> Type a U The display: 



V'FY SAVE 
DEV. #1 
NAME? - 



d) ^ y ? e . tha , name y° u hav e used to the name' 

prompt and <RETURN>. na.ie. 

and hL 2 3 ' ? au U s ^e an OK message 

3-f,^i C Ker " al ro ERROR message, or the 
display will just say error. if this 
happens, first check to make sure you typed 

n^„« eV1Ce nUmbec and the name of your 

$£t E*? ?*? 1 ?' You oan ^ back to the 
Ham Menu by typing any key. Try again/ 



"• 2 aSMS'AJrjs.— -* •—- ' 



on 



a) BLOCKT° U ?f <? h ? ul f »"11 be set to run in 

for block I X ^ Sn l tf reset the DIP sw *tch 
an* .25 ' ,J You have t0 tucn the VIC off 

Iwitch!? the carteid « t0 "aet this 



b) 



c) 



d) 



EPROM ?* ™* PROMQOEEM, and if the Hexkit 
*ll e/ilt.5 Xlt the 2IF a °*=fc€t, turn OFF 
/ *. t 0C i ET switch before dropping Hexkit 
(notched end up) bacic into the zip docket* 

SOCKET ^Al 11 "^ fc 5 e disk ' tu ™ on the 
™ * wltch ™<* ^ad Hexkit into Vic user 
RAM by typing SYS2 9039 <RETURN>. 

Select Menu option C. The display: 

SAVE ON DEV 
DEV,# 
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e) The disk device number 
Type an 8. The display: 



(DEVI) is 8 



SAVE ON 
DEV. #8 
FROM _ 



DEV 



f) Type in S1001 <RETURN>. (This is 
starting address of the Hexkit program 
VIC RAH.) The display: 



the 
in 



3AVE ON DEV 

DEV, #8 

FROM $1001 TO - 



g) Type in 51DEE <RETURN>- 
Hexkit.) The display: 



(Ending address of 



SAVE ON DEV 

DEV. #8 

FROM $1001 TO 51DEE 



?■*" 



h) 



i> 



NOTE: If you make a mistake typing the 
addresses, type X a couple of times, press 
<RETURN>, and you will be returned to the 
preceding prompt. 

Type HEXKIT to the NAME? prompt. The disk 
should begin to save/ and "SAVING HEXKIT" 
will appear on the screen. 



If the SAVE is 
the Main Menu. 



good/ you'll be returned to 



j) To VERIFY that Hexkit for your machine code 
program) has been saved on DISK, type E to 
the Main Menu, 8 to DEV.*, Hexkit tor * 
which tells the operating system to VERIFY 
the last program saved on disk) to MftME? 
and the verifying process will begin. The 
display: 



t 
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V'PY SAVE 

DEV-18 

NAME? Sextait 

Searching for Kexkit 

Verifying 

OK 

k) OK - means that the program has been saved 
and verified- ERSOR - means that 

something went wrong- Type any key to 
return to the Main Menu, 

1) You can reload with the VIC's normal load 
command. Hit RESET, type LOA0*HEXKIT",8 
and after the load r type SYS4112, or 
alternatively, type RUN <RETURN>. This 
works for tape as well r but aoes not work 
on 8K and expanded VTCs> 

1,3.3 To LOAD from TAPE or DISK using Hexkit, type D to 
the Main Menu when it is displayed. 

a) You will be asked if you want to load your 
program to an area other than from where it 
was saved. To the prompt NEW LOC? you can 
answer Y or N. 
An N will load the program back into the VIC 
exactly where it was saved from. Be sure 
and have RAM there to receive it. You 
might get an *out of memory e rror." Hit 
RUN/STOP (RESTORE) if this happens, 
A Y will generate this displays 

LOAD PRM DEV 

DEV.# 1 (or 8 for disk) 

NEW LOC? Y 

WHERE? 

b) Specify the new starting address and your 
program will be loaded starting there. You 
will see the normal prompts and Sernal 
error messages. You can LOAD Bexkit or 
another machine code proarara into the 
PROMQUEEN Rfta £ fl block 3 ("instead of the 
VIC RAM) by typing 560 00 to the where? 
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prompt (provided you said H Y" to the 
n NKWLOC tt prompt). This is called a 
relocate load* This (and other advanced 
SAVE and LOAD information) can be found 
starting on page 49. 

VIC TIP; If you load "PROGNAME", 1, 3 (giving a 
secondary address of 3 to the VIC's normal load 
(command) , the program will load to the range from where 
it was saved f not where the VIC wants to put it. 

1.3.4 To BURN your backup Hexk.it EPROM r follow these 
steps which can also be used for copying any other 
compatible EPROM. 

NOTEs The addresses used for this procedure apply 
only to BLOCK 3, and these instructions are 
written only to acquaint you very quickly with 
promqdesn operations* The extensive options you 
have for relocating or remapping code are 
discussed on pages 32 to 35- If using VICMGN, see 
pages 59 and 60. 

a) Check that the DIP switch is set to BLOCK 
3, set the toggle switches for SOCK£T*OFF 
PROG/MIMIC=PROG PROG/BURN- PROG and 
EPROM*2732. Install the Hexkit EPROM, 
notched end up. 

b) Plug in the PQ and turn on the VIC. Turn 

on the SOCKET and load Hexkit with SYS29039 
<RETURN> . 

c) Type an A to the Main Menu, and type 55000 
<RETURN> to the WHERE? prompt. 

d> The 15-line display as on page 6 should 
appear. Type a T. "* This is one of the 22 
keystroke edit commands you will learn 
about in the Hexkit Tutorial* This one is 
the TRANSFER CODE command. You will be 
transferring the code from the Hexkit EPROM 
to the PROMQUEEN cartridge RAM. Code has 
to be in the PROMQUEEN RAM before it can be 
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burned onto an EPROM. 
" **SFZi3gg WU1 ■"»« « the ootton, 



XFER PRM - 
Type ,7000 < RETORN > to the XFER pRM prompfc 

the first 0/ avS P QV ' .-k"^, blinfcffl 9 °" 
and hit <HETORN>! *** ° * wltJ » 6FFP 



f) 



XFER fRM S7000 
STOPS 5PFF 



S/c^'ft^^""' add?ess ** the 
PROhqueen is set o„ „l 6 ^ IC when the 
STOP e defines the LAS^a^L^ BL0CK 3) • 
use in the worksn«n» ^= fu teas 70u wan t to 

*ou can thinTof *!top« »- PR0MQDEEN RAH. 
line on a meMnrino 2, y«? ethln « g like a 
code from the eprqm I*. ? U are P°uring" 
into the raSoffW "S" 1 ? H° m S70 °° 
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g> Bexkit has now been copied from the VIC RAM 
into the PQ RAM and is ready to be copied 
(BURNED) On an EPROM. 

h) Turn OFF the SOCKET switch , remove the 
Hexkit EPROM, put in a blank 2732 EPROM, 
and turn the SOCKET switch ON. 



i) Type X to get back to the Main Menu and 
to access the BURN routine. The display; 

BURN EPROM 
FROM 



B 



j) Type $7000 <R£T0RN> (lowest address in PQ 
RAM '+ 1000) to the FROM prompt and $7FFF 
<RETURN> to the TO prompt. 

k) If the screen turns black and says 

ERASE EPROM 



r- 



the program found data other than $FF in 
the address range you gave* Type an x to 
respecify addresses/ or try another EPROM 
(don't forget to turn off the SOCKET during 
the change) . The program will retest for 
erasure when you type a <RETURN>. 



all SFF's were found in the given range 



1) If 

of addresses, the program will instruct vou 
to set the BURN/ PROG switch to BURN. Make 
sure the EPROM type setting is correct 
before doing so. When you flip the switch 
to BURN, the red LED on the PPvOMQOEEN comes 
on. it tells you the program voltage power 
supply in the PROMQUBEN is working." 

m) Hit a <RETURN> to start the BORN process. 
No actual burning occurs (unless the EPROM 
is in backwards) until you tell it to start 
with this <RETURN>. 
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The minw *~ *■ REMEMBSR 

" SUET'S? ^.X, " > m "•> »" 

BURN VERIFIED _ 

q) If instead you see prrcio ,*. 

address, the PRomqceen iT7i, i •' SOme ha * 
the data found if thf^ J& tellln 9 ? ou that 

is not identic,! fn rt^l! the EPR0H 
corresponding ad&ss'Vooo b £<* , in "?« 

X. If the burn has errors rL^" 9 an 

Programing voltage TsL ^IT^ *** ?he 
try another EPROM? ^ 9<a 51) are 9°°°' 
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1.4 SDMMARXs EPROH DUPLICATION 

If you're in BLOCK 3, you can copy any 2732 EPROM by 
using the procedure on pages 16-18 and summarized belowt 



a) 



b) 



Load Hexkit into VIC user RAW 
page 9). This is SYS 29039 in 



(see the table on 
BLOCK 3. 



Turn OFF the SOCKET switch, replace HexKit with 
the EPROM to be copied/ turn ON the SOCKST r and 
transfer the contents of the EPROM to the PQ RAM 
by these steps: 

1> Type A (to the Main Menu) , give the 

starting address of the PROMQCEEN RAM 
(which is S6000 in BLOCK 3) then type a T 
fof the transfer function <you transfer 
from 57000 in BLOCK 3 and give the STOP? as 
6FFF) . 



c) 



2) Then follow steps 1) through 15) 
BURN routine summary on page 58. 



in the 



If you don't want to copy the entire EPROM, just 
add 51000 to the lowest address and $1000 to the 
highest address of the contents of the PQ RAM that 
you do want to BURN. Give those addresses to the 
prompts of the BURN routine. 

This completes a brief walking tour of the PROMQUSEN 
cartridge. To learn more of the many things you can do 
with it, read on. 
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I; Set your pq 



-oet your PQ to 

2J toad a BAciTr « 
6) Tap the R£SE 

1) f et . the PROMQDEEN *- 

°ack into the v^ ° run ** block * , „ 
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2) Load the BASIC program from tape/ disk/ modem, 
however you want to do it. 

3) Run the BASIC program to make sure the pointers 
are properly set. (See the VIC-20 "Programmer's 
Reference Guide" for the VIC's memory map- You'll 
find that BASIC -keeps track of where it starts, 
where the variables are, etc. in locations S2B 
to $38+ These are the pointers in question. 
Stop the program. Type SYS4S312 <RSTURN> to save 
the BASIC into the PQ RAM ready to burn onto the 
BPRGM . 

4) Load Hexkit off the EPROM with SYS45441. Select 
Menu option B to burn the EPROW. Put a clear 
EPROM in the PQ and BURN from addresses SBO00 to 
SBFFF (or less, if your BASIC is shorter) . If 
your BASIC is really brief, it may fit on a 2716, 
otherwise, use a 2732 or 2732A. Once the BURN 
procedure is complete and VERIFIED, X yourself 
back to VIC BASIC, and, since you* re in BLOCK 5, 
type SYS45441, Yoxxt BASIC program should begin 
running* 

That's all there is to it. 

The EPROMs made with the aid of SYS 45312 have a header 
put into the first 512 bytes that gives these EPROMs 
unusual properties. 

1) You will be able to reload and run the BASIC 
program off the EPROM, from whatever possible 
location a 4K EPROM socket can appear, anywhere in 
the VIC's expansion space. All you have to do is 
use the right S"£S command to load and run the 
BASIC off the EPROH, You do NOT need a "run time 
package" to make this possible. Various VIC-20 
expansion cards give various possibilities of 
"where" to plug in the BPROM. 

23 if you plug an EPROM made with the aid of SYS 

45312 into a circuit card that has a socket with a 

start address of $A00O, the VIC will oe 

auto-started with the BASIC program, and the STOP 

• key will be disabled. 
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There are eight possible locations in the VIC a expansion 
space where a 4K EPROM can be put* The possibilities, 
along with the SYS commands the LOAD and rum the EPROMed 
BASIC commands are listed below: 











COMMAND 


COMMAND 










TO LOAD 


TO LOAD 










AND RUN 


AND RUN 




EPROM 


EPROM 




BASIC 


BASIC 


VIC 


SOCKET 


SOCKET START 




FROM EPROM 


FROM ERROM 


EXP 


ADDRESS 


ADDRESS 




TO UNEXPANDED 


TO EXPANDED 


BLOCK 


HEX 


DEC 




VXC CI) 


VIC <2> 


1 


$2000 


8192 


SYS 


8514 


XXXXXXXX 




53000 


12288 


SYS 


12619 


SYS126 82 


2 


$4000 


16384 


SYS 


16724 


SYS16784 




$5000 


20490 


SYS 


20829 


SYS20336 


3 


56000 


2457$ 


SYS 


24934 


SYS24988 




$7000 


28672 


SYS 


29039 


SYS29090 


5 


$A000 


40960 


SYS 


41336 


SYS41384 




$BO00 


45056 


SYS 


45441 


SYS45486 



CI) The commands all put the screen at 51E00 first, 

(2) These commands do not relocate the screen before loading the 
BASIC. 

If you have an expansion card, and it takes , or you 
doctor it to take, 4K EPROMs, you will find that the 
address location of the ERROM socket will be 
address ranges from the table above- 



one of the 



The ERROM location at $A00O is special. At this 
location f an EPROM made with SYS 45312 will, on power up, 
autoload and start the BASIC program you've burned on it, 
provided that it's for an unexpanded VIC* If you want 
to have AUTO START for an expanded VIC, see pages 68 to 
72- Put the EPROM anywhere else, and you can, from the 
keyboard or from software, use the relevant SYS command 
from the table above to load and RUN the EPROMed BASIC, 
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If you are putting several BASIC programs on the 
up-to-exght 4K EPROMs you can put in the VIC's expansion 
spacer you will want to reserve this auto starting SAGOO 
location for a main menu you can write in BASIC and burn 
on EPROM with the aid of SYS 45312. 

Remember also that an auto start or reset through an 
EPROM made with SYS 45312 and located at SA000 will lock 
out the STOP key* You probably want this feature in your 
finished program, but you must remember to include in 
your BASIC program some way to stop it through software 
during development- The STOP key can be reenabled by 
executing a POKE 808,1X2 command. You might save time if 
you put this command at the start of your program, and 
delete it only when ready to BORN the final version. 
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2.1 THE HBXKIT 1.0 TUTORIAL 

INTRODUCTION 

ra^H?" £!«-' Sfsiaa 

course, U3e the* prohqoeSj's mimic m'od 6 t/ L= I 3 "' ° f 



z * lo January 19S3 



MEMORY MAP 



8k - 



8k - 



8k - 



8k - 



8k - 



8k - 



8k - 



512 b.- 

4k - 



3k- J 



Ik 



- L 



VIC 

KERNAL ROUTINES 
ROM 



VIC 

CBM BASIC 
ROM 



BLOCK 5 



COLOR MEMORY, I/O, 
&CHR. GENERATOR 



BLOCK 3 



BLOCK 2 



BLOCK 1 



screen memory 



USER BASIC 



$E000 - $FFFF 



$0000 - $dfff 



] 



$B000 $BFFF 



$A000 $AFFF 



$8000 ~ $9FFF 



I $7000 $?FFF 



j $3000 - $3FFF 
I 

1 $2000 - $2FFF 



$1E00 - $1FFF 



$1000 ~ $1DFF 
loads here 

3k ram expansion space | $0400 - $0FFF 
operating system ram | $0000 - $03FF 





$6000 $6FFF 



$5000 $5FFF 



' $4000 $4FFF 



EPROM 
socket 



RQ. 
RAM 

EPROM 

socket 



P.O. 

RAM 

EPROM 
socket 



RQ. 
RAM 
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2-2 SYS COMMANDS TO LOAD HEXKIT 

Hexkit Is loaded from its EPROK into the VIC by a SYS 

command executed in immediate mode- The address to use 
with the SYS command depends on the expansion block in 

which the PROMQUEEN is set. The starting address of the 

space available for user programs also depends on the 
BLOCK switch setting; 



SYS TO LOAD 


OSSR PROGRAM 


DEVELOPMENT. SPACE 


BLOCK 1 
BLOCK 2 
BLOCK 3 
BLOCK 5 


SYS 12619 
SYS 20829 
SYS 2903 9 
SYS 45441 




$2000 - S2FFF 
$4000 - S4FFF 
$6000 - S6FFF 
$A00O - $AFFF 


The screen will be put 
Hexkit. 


back ■ 


at S1EO0 when you lo 



2.3 PROWQOEER, BBXKIT, AHD VIC ADDRESSISG 

Study the simplified memory map diagram on the opposite 
page. Notice which memory allocations belong to the VIC 
and which are available to the PROMQCfEEN. 

Thece are four 8K expansion blocks made available by the 
VIC. These are rather like vacant lots: the addresses 
are assigned, but the houses aren't there. Think of the 
PROMQUEEN user RAM and the Hexkit EPROM (ZIF) SOCKET as 
two K mobile homes " that you can move around. Their 
addresses depend on the DIP switch BLOCK setting. If, 
for example, you set the DIP switch to 1, the promqueen 
RAH will occupy "space" at addresses 

12288-16383 ($2000-S2FFF) , with the EPROM socket in 
addresses ?3G00~$3FFF, right next door and also in BLOCK 
1. 

Take another look at the diagram, what addresses would 

the PROMQUEEN RAM occupy if the DIP r or BLOCK, SWITCH 

were set at 5"? What addresses would the PROMQUEEN EPROM 
SOCKET occupy if the DIP switch were set at 3? 
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When you type such commands as SYS 12619 (DIP-BLOCK 1) 
the Vic looks Cor address 12619, finds it on the Hexkit 
EPROM in the EPROM SOCKET and begins to execute the 
machine code program that it finds there. This program 
loads the flexkit operating software into the VIC user 
BASIC RAM- (after resetting the screen to 51EQ0) . 
Regardless which BLOCK you use, Hexkit always occupies 
4097-7679 ( $1001~$1DFF} in VIC BASIC SAM. 

A later section in this manual tells you how to "remap" 
Hexkit to run where you want it to if you want to free up 
the space in VIC user RAM from $1000 to $1DFF. 

You will be writing your programs in the PROMQUEEH RAM, 
and the addresses you use will depend on which BLOCK 
switch you use, For example, in BLOCK 2, the user 
program space is from address ?4000-$4FFF- When you BURN 
your programs onto an EPROM, yog will be referencing 
EPROM socket addresses, which in this case, would be 
95000 to $5FFF. This lets you put your program anywhere 
you want to on the EPROM as long as the addresses 
correspond. For example, if you have a program in the 
PROMQUEEN RAM that ' runs from addresses $4009 to 54BBB, 
you'll be burning it at $5009 to $5BBB. 

Look at the diagram* if you have a program at 56ABC to 
$6DDD, what BLOCK are you in? Are you in PROMQUEEN RAM 
or in the SOCKET? If you want to BURN this program, what 
addresses do you use? 

Study the memory map in the VIC programmer's reference 
and the tables on pages 25 and 54. You will see that you 
have four choices where you can set the cartridge. To 
work all the practice examples given in the next few 
pages, the cartridge must be set to operate in BLOCK 3, 
This means the PROMQUEEN RAM can be used for our program 
development in the range of addresses from $6000 to 
56FPF, and any EPROMs in the PQ's ZIF socket can be 
accessed by adding $1000 to the current PROMQUEEN RAM 
apace addresses* (In BLOCK 3, EPROM access « 57000 to 
S7FFF.) A code routine on the HEXKIT EPROM will download 
the whole Hexkit program into the VIC's memory when you 
type SYS29039 <RETURN>, 
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2.4 &OADIHG HEXKIT FOR A PRACTICE R0N 

Make 3ure your VIC is turned off. Remove the PROMQUEEN 
cartridge from the VIC and set it to run in BLOCK 3* The 
toggle for BLOCK 3 is the second from the left on the 
BLOCK DIP switch* Set the top of the rocker switch in. 
Remove any other expansion you may have on your VIC that 
occupies BLOCK 3. Turn up the sound, if any, on your 
monitor. 

Plug the cartridge back into the VIC's expansion port, 
turn on the VIC and turn OFF the SOCKET switch* If you 
will be using the disk drive, you must insert your disk 
and initialize it before you start Hexkit 1.0.* The 
program does not do this for you. Execute this BASIC 
statement In immediate mode: OPENl ,8,15, w I n <RETURN> 

Put your Hexkit EPROM in the 3IF socket. Remember that 
you must turn OFF the SOCKET switch whenever you change 
EPROMs. The notched end of the EPROH must face the top 
of the cartridge. Latch it down and turn SOCKET switch 
ON- The other three switches should be vertical. You 
should see the green LED on the cartridge come on. If 
the green LED isn't on, you can't read the contents of 
the EPROM. 

To load Hexkit 1.0 when the cartridge occupies BLOCK 3 
you type: SyS29039 <RETDRS> 

The program will start to run by itself. 

The Main «enu is displaying the five main options 
provided by Hexkit: 

EDIT HEX A 

BORN EPROM. B 

SAVE ON DEVICE..- ,C 

LOAD FROM DEV. D 

V'FY SAVE E 

The option is selected by typing A, B, C, D, or E, and no 
<RETURN> is necessary. Once in any Menu option you can 

type an X to get back to the Main Menu. Typing an X from 
the Main Menu returns you to the VIC's BASIC operating 
system. 



* NOTE; You must also close the disk, channel after 
saving to disk/ hut before you turn off the drive, so as 
to update the directory. 
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You can stop the execution of Hexkit whenever the Main 
Menu is displayed by typing an X. If you do so, the Menu 
is not cleared from the screen, but you'll hear the sound 
effect, and see the "READY™ message and cursor appear at 
the bottom of the screen* You are back in VIC BASIC. 

To get back to Hexkit from the VIC BASIC operating 
system, clear the screen and type HON <RETURN>. 

The RESET button on the PROMQUEEN cartridge causes a 
"cold start" to be executed by the VIC. If you tap it 
you will get no result if you then type RUN, but you can 
3till restart Hexkit by typing? SYS 4112 <REruRW>. This 
is because the cold start wiped out the single line of 
BASIC in Bexkit which is: 1 SYS 4112:END. 

Stop the program by typing an X. Enter the above line of 
BASIC followed by a RETURN* Then/ type RUN <RETDRN>„ 
This restores the RON start. 

I*f you enter any BASIC programs with numbered statements 
when Hexkit is loaded into the VIC BASIC memory, you will 
probably be typing over Hexkit, wiping out some of it. 
Just reload Hexkit when you are finished with the BASIC 
by using tbe appropriate SYS LOAD command from the table 
on page 25. you can execute any BASIC commands in 
immediate mode when Bexkit is loaded but not running/ 
without causing it any damage. Hexkit does not protect 
itself from BASIC by resetting any pointers. 

You can also "cold start" Hexkit by simply typing SYS 
4112 <RETDRN> or SYS (wherever your Bexkit is located) if 
you have remapped it elsewhere. 



2.4.1 USING THE EDIT HEX ... A 

After you select the option to EDIT HEX by typing an A, 
the menu will disappear/ and you will see the following; 

EDIT HEX 
WHERE? 



GCI/tbs 29 15 January 1933 



2.4.2 DSING #, S, OR MARKER TO SPECIFY ADDRESSES 

There are three ways to tell the program where you want 
to Edit Hex* ^ou can give the address in decimal if you 
precede it by a "#" sign and press RETURN after your 
entry* You can give the address in Hex if you precede it 
by a n S" sign and press RETURN. You can also type an M 
and a Hex number from to F to reference a previously 
assigned "MARKER. 11 You will be able to practice using s, 
#, or H in the section below. No need to press RETURN 
when referencing a MARKER- In addition, if you had 
selected EDIT HEX by mistake, you could pop back to the 
Main Menu by typing X. 

To the WHERE? prompt of EDIT HEX type the address $6000 
in Hex and then <R£TURN>. 

You should see the EDIT HEX display. If you look at the 
line that the cursor is blinking on you should see the 
decimal address #24576, Hex address §6000 , and a byte of 
machine code. The cursor should be blinking on the 
high-order nybble of the code. 

Press the X key, to get back to the Wain Menu, Select 
EDIT HEX again by typing the an A. This time, give the 
same address in decimal by typing #2457 6 <RET0RN>. 
You'll see the same display, (Nothing happens unless you 
type the #.) 

Now, type an M. You'll see the prompt "MARK" appear in 
the prompts area at the bottom of the screen. At the 
same time r an M will appear at address $6000 in the 
leftmost column of the display, the cursor blinking next 
to it. Type a (zero) - You see that you have MARKED 
location $6000 as M0« 

Type an X to get the menu, an A to get EDIT HEX, and this 
time answer the WHERE? prompt with M0. You'll get back 
to your marker at $6000 £24576) £M0) . 

Look at the display. Five columns of information are 

available. The leftmost column is for MARKERS. The next 
column is the address in decimal to make it convenient 
for interfacing your code programs to BASIC- The third 
column is the address in hexadecimal. The fourth column 
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has the current contents of the address given ag a 
two-digit Hex number from to PP (0 to 255 in decimal) , 
The fifth column may not have anything displayed now, but 
it shows any VIC characters represented by the code in 
the fourth column. Notice that 15 addresses are 
displayed this way 30 that you can see the contents of 
the range of addresses around the address you have 
selected to edit. 



2.4.3 SCROLLING 

You can SCROLL the display in either direction with the 
CURSOR UP and CURSOR DOWN keys. On CURSOR DOWN, the 
display scrolls to lower-number addresses, CURSOR UR 
scrolls to higher-number addresses. The cursor keys are 
repeating and silent. If you want to be sure to scroll 
only one step at a time and hear a beep so that you can 
hear your progress while looking at your notes, use the 
£5 SPECIAL FUNCTION key to scroll to lower-number 
addresses, or the f7 SPECIAL FUNCTION Key to scroll to 
higher-number addresses* Scroll around by various means 
to various addresses. 

Whenever the display stops, you'll see the cursor 
blinking on the first digit of the hexadecimal contents 
of the middle address displayed. The blinking cursor 
shows where your editing entries will be stored. Scroll 
the display to some address above 56000 and stop. Sow, 
try typing some numbers in hexadecimal. Hear the sounds 
and observe the display* You'll see the numbers you type 
entered in the cursor location, and the display will 
scroll to higher addresses. It takes two keystrokes to 
enter a byte of hexadecimal code. 

TO GET BACK TO k TARGET ADDRESS when editing, use the f8 
(shift/f7) SPECIAL FUNCTION key. For example, try 
scrolling some distance from $6000. Type f8« This will 
generate the DISPLAY prompt. . Type $6000. The program 
will take you to any address you specify to the DISPLAY 
prompt of the £3 key. Note that the f8 DISPLAY prompt 
accepts $Hex, #Dec or Mn MARKER where n * the number you 
assigned the MARKER. The asterisk merely indicates where 
you left the program when you called for a special 
function. It is not a "Permanent marker." 
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2.4.4 IP YOO hake A MISTAKE on the first nybble of code, 
you can abort the entry by typing an X. Try it: type 
one Hex digit, then an X, and observe that the cursor 
backs up to the first digit (but the display does not 
scroll) . If the cursor: has been blinking on the second 
Hex digit of the edit address, you'll find that function 
keystrokes don't work?' you'll hear the auditory feedback 
- raspberry - for an invalid keystroke. SPECIAL FUNCTION 
keys work only from the leftmost nybble of code- If you 
hear the raspberry (invalid entry) audio feedback, get 
back on the first digit by typing an X. If you type any 
SPECIAL FUNCTION KEY by mistake, you can abort by typing 
an X. If you press $, 9, or H, you can still abort by 
typing an X after the M or by typing at least 2 X's after 
the $ or * <P.ETURN>. Note that you don't need a RETURN 
after a MARKER reference* Any invalid number entries 
also cause an abort. The program does not accept any 
commands except those discussed in this tutorial. If you 
type addresses larger than 4 or 5 digits (Hex or Dec) the 
excess will be ignored. 

In general, when in doubt, type X. That will usually 
help. DO NOT USE CURSOR UP to get back into the code 
from the prompt window. Type X's and returns instead* 



2.4.5 THE CONVERT DECIMAL FUNCTION - K 

Use the f8 key to get back to 56000- Try typing a K. 
The prompt, CNVRT DEC and the blinking cursor appear in 
the prompts window. if you give this prompt decimal 
number 255 or less, you will see the number converted to 
Hex and entered in the address where the cursor had been. 
The display will scroll to the next address* A number 
between 256 and 65536 will be loaded into two bytes, and 
the screen will scroll two address locations* The 
two-byte converted number will be entered in 
6502/2-80/3030 , etc. forraat p with the low-order byte at 
the lower address. Try converting 255. Don't enter the # 
sign first, and be sure to <RETURN> after ycur entry* 
you'll see FF entered. Try converting 40960. You'll see 
00A0 entered. Try 65535 and you'll get FFFF. Try 
anything invalid, and you'll get an abort. Again, don't 
enter the # sign first, and be sure to <RETDRN> after 
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your entry- Get back to S6000 when you ace finished. 



2*4.6 A WORD ABOOT THE SOOND EFFECTS 

Notice that you get a boop noise every time you call for 
one of the special keystroke options of the editor. In 
general, the noises made are "boop" for editor options, 
"beep" for the first digit of a hexcode entry and "bip" 
for the completion of any entry or task. You are 
probably already aware of the noise it makes if your 
entry was none of the above or if an abort occurs* 



2.4,7 MOTIBG BLOCKS OF CODE - T 

After you've gotten the display back to $60 00, type a T 

on the VIC keyboard. Notice the prompt "XFEK FROM" and 
the blinking cursor appear in the prompts window. The T 
command is the means by which you can relocate blocks of 
code. The code is always moved TO the area the screen is 
displaying- In other words, after the move, the first 
address of the block of code that is moved (copied) will 
become the address of the line on which the blinking 
cursor appears- Try this examples 



1 . Type an 
listing. 



X to get you back up into the code 



2. 



Scroll to address S600A and enter recognizable 
nonsense, such as AA, BB, CC, DD, BE. 



3. Call $6000 back by using £fl. 

4. Type T< 



5. 
6. 

7. 

8, 



Answer the prompt XFER FROM with S600A <RETURN> . 

Count the number of nonsense bytes to be moved - 
in this case, five. 

Add five to $6000- This equals $6005. 

Type 56005 <RETURN> to the STOP 9 nnnn prompt. The 
code should be copied, in its new location. 
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at 
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ssnnS! n y ° Ut ;°"9inal code" still can be found 

Hex into JISV 931 "' S ,T P@ d6 ? ines the LAST add "^ 
Thf LlLc 1 ^ youwill permit the transfer to occur. 

»»5ir i 3 ess Er0nl Which tbe bli »king cursor was taken is 
EE M j£ n? "terisk and is now the first new address of 
^npa mnl°L COde . Y e U re 9oing t0 be copying. Note that 
f^l Ja^ b6 set w t0 a HIGH ER address than the current 
edit address, or the transfer will abort. 

sLrrh\ n n e / t p™! mp1 , 8 - <£* wiU be used t0 demonstrate the 

^ t i,^ aP factions. Locate yourself at $6000. 

<RETORN>. Answer the ST0P8 prompt with 6220 <RET0RN>. 

fi^oW ^fL 0E i? decin, al preceded by t) , you'll see 

r^L h fr P ?K ar , after the STOPS Prompt. The progrm 
remembers the last STOP and gives you the chance to r!u™ 

iw ^^ by ^P 111 ^ the <RETORN>. If you want to chana* 
w% hT^ 3USt K "P! the new addr9S3 ov " tte old. It 

for a I T 0P Ven vn,r^« ° k Y ° U ^ neXt time * ou are Prompted 

L , \k l™, allort the transfer by the same means 

that abort the DISPLAT WHERE? functions <type x) , and if 

STOP? ul? ab ° rt afte f, 9 ettin * ail the way tot 

ssfirsf h'it^T.tSri 1 ao 3o by xing out the stop 

hpv fc i?il„ ti -11.' JSS^ screen should be indicating the EDI"- 
HEX mode with $6000 as the center address. You will have 
^ nS tht"« d * U - P t0 ^6 PROMODEEN RAH £ COra the VIC-s B«IC 

thS print!™ ITrZl thB ****}' 1 *° prg ™ that manges 
the printing to the screen of all the prompts, logo, etc. 

5601 Y E von C „°ni "<TV he addreSS ra " ge *«■ *«000 to 
that J^iS 1 ^ Poking at a 6SC2 machine code program 

of ni^Sfai** P *. subcout in«- " manages the printout 
of messages which are numbered from to 26 in 

■SSffi? 1 - -^ hen thS meSSag9 n^ber is put into the 
accumulator with an LDA instruction, and the routine is 

Prinlfd'" Th» a JSE inst ruction, the specified message is 
Itr?nn** Jf?l ,nessages themselves are stored as character 
strings wtuch you can see starting at $6 OIF. Start 
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scrolling past S6G1F and you will see the messages 
scrolling by in the fifth column of the display. Wotice 
that each message ends with a zero byte so the routine 
knows where it ends* Some characters are not indicated 
in the fifth column. These are spaces, control codes r 
color codes, etc. 

We can run this routine r but it will not work at address 
$6000 because it was written to run at S1B6B. To make it 
work at 56000, we must "remap" it. No problem here. 



2.4.8 SEARCH HJNCTIOH - U 

Get the display back to 56000 (remember the f8 *ey?) . 
Hexkit 1,0 gives you two different ways to search through 
memory to find specified bytes. Let's use the keystroke 
U first. Type a 0* You will observe the following pop 
up in the prompts area; 

SEAHCa 20,*9,*C,*D,+E 

The cursor will be blinking on the 2. 

This is another one of those remembers-the-last-entry 
functions. When you press <RETURH>, the program will 
start searching the code from the cursor edit point to 
find the next byte in a higher address that is a 20 (in 
Hex) , or any other byte that ends with 9, C, D, or E. 
This will catch all 6502 opcodes which may have to be 
remapped. The asterisk means "don't care."* You can put 
an asterisk in the high-order nibble, the low-order 
nibble, or both. If you typed over this prompt so it 
becomes 

SEARCH 20,**,**,**,** 

the function will only look for "20" bytes. You can 
SEARCH for any five individual opcodes or operands you 
specify, and these five bytes will be remembered every 
time you use the (7 function. The program will stop on 
the first one of the five it comes to, regardless where 
the byte is located in the search command string. You 
can also abort; type some Xs and hit return to abort. 
Leave it as is for now and hit the <RETUSN> key. 
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opcodes with an operand which mav 111 t t ne ? f the 65 °2 
you are remapping! This time it^n!! fc ° be changed when 
on the first byte after such an JSZ%' . Th f dls P la y stops 
uae of the re^p functiofS UrtffiTJ* faollit ^ your 



2.4.9 REMAP FUNCTION - R 



R. 



mFs?^™" - MBS 

v =.i„ Q f ir,.7._ rn " 1S another remember - f-h« 1 



Type an 
in Hex 

last'"- ; a YuV f^ctVon ^You^"^" reme_mb « " «" 
you want to ad It "'the oH t SPeCify What offset 
Calculate the offs^^^f ^^je-P the COde " 

new location of routine 
- old location of routine 

= offset required 
In this case it is 



$6000 
- S1B5B 



(You must do this 



xn Hex) 



$44*5 



P&^^KL-S?, gfaS-u^ «■». The 

two locations, * raa PP^ and the display scrolled down 

<La>! eC Want t0 * bocfc this f x out the offset and hit 



Two things to look out f 



or; 



1) 




of bytes that 
notes on your 

isslzP "™°« ?<sw ii 2r c c or ands 
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2) Sometimes you will be remapping downward in 
the memory space* To get the right offset, first 
add 510000 (ten thousand Hex) to the new location 
of the routine before you do the subtraction 
above. 

One more operand must be remapped before this routine 
will work at $6000. Ose the function again. Now the 
display should be relocated to $6009. This is another ED 
<load the accumulator absolute indexed by X) instruction, 
and must be remapped. Hit the R key. you 1 11 see your 
offset of 44A5 remembered — it is still good. Bit the 
<RETURN> key, and you will have completed remapping the 
message printer routine. 

2.4.10 SEARCH XQR SPECIFIC ADDRESS - Q 

Remember that the message routine knows where messages 
end by detecting a zero byte r but it raust look up where 
the messages start in a table. The start of the table 
can be found by using the other search function in Hexkit 
1.0. The first address listed in the table we know from 
our notes. It is UB7A tin Hex). Type a Q. See the 
prompt SEARCH and the (probably) 0000. Type over the 
zeroes with S1B7A and hit <retorn>. We have found the 
start of the table. The cursor is blinking on the 
low-order byte. This address needs to be changed. Type 
an R and <RETORN>. Unless you changed it, the offset we 
calculated ia still there. Type R <RETORN> decimal 38 
more times to remap this particular table. CQ has done 
its work — you don't need it anymore.) If you ever want to 
abort a Q search when you have selected it by mistake , X 
out the number after the prompt and hit <RETURN>. 
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The routine is ready to work now at its new location, but 
we must give it message numbers before we call it, Let's 
enter the necessary routine at address $6400. use the £6 
key to move the display there- The routine below will 
drive the message routine to print the first 10 (in Hex) 
messages from the message table. 



M &GDE££S 



Ml 



6400 
6402 

6403 
6406 
6407 
6408 
640a 
640C 
640E 



6502 ASflttM 



U>A#$O0 


AS 00 


PEA 


48 


JSR$6000 (message) 


20 00 60 


PLA 


$8 


CLC 


18 


ADC01 


69 01 


CMP#$10 


C9 10 


BCC Ml 


90 - 


JMP50FB (get in) 


4C FB 10 



<F4) 



Starting at address S6400, type in the codes A3 and 00. 
These two bytes tell the 6502 to put zero into its 
accumulator. Before you type the next code <48, which 
pushes the accumulator onto the stack), mark the location 
by typing an M and then a 1. You will see that this 
location has been labeled Ml- we did this to allow 
Hexkit to figure how to branch back to here later. 

Now enter the 48 hexcode, and proceed through the rest of 
tire routine until you have typed the 90 instruction into 
location S640C. 

We stopped at S640D because the routine contains a loop 
which is terminated with a conditional branch instruction 
at address S640C. Hexlcit will help you find the 
necessary offset to $6402 because we have MARKED the 

;? Ca ^™^ t0 where fche bra ^h must go. Wow you can use 

the OFFSET function of Hexkit- 
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2.4.11 THE OFFSET FUNCTIOH - 

Type an 0. You will get the prompt: 

LD OPPST M 

and a blinking cursor* Type the marker number/ which is 
I- Then you will be asked 

PUT H OR T 

meaning "put the offset HERE (at the current edit 
address) or THERE (where the marker was assigned)." This 
is a branch back, so we need the offset HERE- Type an EL 
Anything typed other than H or T aborts the function. 
You could also have aborted earlier by typing anything 
other than a Hex number after the H. The function aborts 
automatically if you have aske<3 it to calculate too long 
a branch. This time it should work; the number you see 
entered is the proper signed two's complement form. Go 
ahead and type the rest of the program (4C PB 10) . 

2-4.12 BACKWARD AHD FORWARD BRAHCH OFFSETS 

You will find that branch instructions may occur forward 
or backwards. Backwards branches work just aa the 
example we performed above. To use Bexkit on FORWARD 
BRANCHES r mark the location where the offset must go f 
leave a space £or it (enter FF in the location, or tap 
the f7 key) and continue entering the program until you 
come to the statement to which the branch must occur. 
Then use the keystroke and tell it to put the offset 
THERE by typing a T. 



2.4.13 DEBUGGING AID FUNCTIONS - P p J, N, L 

Remember that all functions are summarized for quick 
reference on pages 54 to 56. 

We can use the debugging aids to check the routine we 
have been working on. Scroll the display back to the 
beginning (at $6400) and start scrolling down. At the 
low-order byte of the operand of the JSR instruction (the 

display at 56404) , stop scrolling. 
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instruction at a"^^^^ S'l %* fly t90 \ 
abort™ *£ J ,:« Lr and P are a11 instantaneous; you can't 

put «. ai'.^i"'.?".™.! 1 " rA'vr KjoVr • 

convenience with HA. location for 

2.4.14 IHXTIATE MACHINE CODF vwnr»a»c« ^„ 

the cursor location. B P .iL ,2^ by ^P"* an I at 
the first byte of tle ««??£! ' - ^ bllnfci ng on 
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16 prompts printed to the screen. We added the call to 
the routine "get-in" to aur routine to freesre the action* 
Type any key- to see the normal EDIT HEX display at 56400* 

* NOTE THAT all text so far is based on an ongoing 
lesson. All addresses and markers are geared to one 
specific routine. 

If you' are not successful at this point, go back and try 
once more- You need the running routine to carry out the 
rest of the sample routines- Move to address $6500 for a 
demonstration of additional useful functions. 



2.4,15 C/HODE FOR AUTOMATIC VIC ASC CONVERSIONS 

After moving to $650 0, SPECIAL FUNCTION key fl. C/MODE 
appears in the prompts area, and the cursor is in the 
fifth column of the display to indicate the program is 
ready to enter the VIC ASC value in Hex for any key 
except the special function keys. In C/MODE, type your 
name. Watch it be entered in Hexcode letter by letter* 
Notice yoq can also type the cursor controls, color 
controls, reverse on, in fact any key on the main body o£ 
the keyboard for which an ASC value exists, and it will 
automatically be converted to code and entered. This 
makes it easy to make message tables for all kinds of 
displays. Hit A again to get out of C/MODE • 

When in C/MODE, you can insert a zero byte to indicate 

end of message just by typing f3, (This key is disabled 
in normal mode.) 

You can tag the beginning of your messages with a marker 
when in C/MODE by typing f6. You then give the marker 
number in the usual way. 

In addition, you can insert and delete spaces- To insert 
a space at the current edit position, type f2. You will 
be prompted with the message INSERT and the current STOP? 
location, this defining upper boundary of the list of 
code which will be shifted to open a space. It must be 
greater than the current edit location or the function 
aborts. To abort intentionally, X out the STOP address 
and press <RETURK>. 
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2.4.16 THE STOFF FUNCTION - S 

One last keystroke remains to be explained. The S key 
calls the STOFF function. This will stuff all memory 
locations from the current edit position on up to the 
address of the STOP9 location with any byte you specify. 
Just check that the STOPS is where you want it, type over 
it to change, or X it out and press <RETURN> to abort. 
Once you have pressed <RETURN> f you will be asked for the 
byte to stuff with. Give it the byte you want or 2 X's 
to abort, and press <RETURN>. Be careful with this one! 
It works very fast. 

GENERAL COMMENTS ABOUT THE HEXKIT EDITOR 

The Hexkit 1.0 Machine Code Editor is a useful general 
purpose tool intended to make the VIC-20 equipped with a 
PROMQUEEN^ quite serviceable for 6502, z-80, 8090, 8085, 
etc* machine code development; however, be careful if you 
are coding for a 6800, 6809, or 1802. We think that you 
will find it a little harder to hand code your programs 
than to use an assembler* but if your documentation is 
thorough, you will probably come to find it much easier 
to debug routines written in code than to edit with an 
assembler. Take a little time to practice now. Your 
efforts will be rewarded. When you have satisfied 
yourself with EDIT HEX, just type an x or two to get back 
to the main menu. 
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2.5 MOTHER ADDRESSING REVIEW 

s££ assays? fS 

remap code for external I Remember, you don't h,l J? 
EPHO« socfcet C a r 7 s ^ £ a ^sted in "th, Targe? 
cartridge's MIMIC mode. USlfl9 a 3"nper cable and the 

2-6 THE HEXKIT l.o 8DRS EEB0| , S0DIIBE 

«~ «** the jss.^ artft*^ 
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prompts with the starting and ending addresses on the 
EPROM into which you want to copy PQ RAM address 
contents. If you tell the cartridge to burn addresses 
(start address of EPRGMJ + 5 to (start address of EPROM) 
+ 25 f it will find the code in the range of addresses 
from (start address of PQ RAM) + 5 to (start address of 
PQ RAM) + 25. The address FROM which the code burned on 
EPROM is fetched is always the address where the code is 
to be burned minus Hex ?1000 (decimal 4096) , 

when you set the cartridge to BORN, you isolate its data 
bus from the VIC* The cartridge is placed into an 
altered logical condition in which it looks for the VIC 
attempting to write data into the EPROM in the ZIP 
socket. Whatever the VIC writes doesn't matter, because 
the PROMQ0ESH data bus is disconnected from the VIC. 
Instead, the cartridge will freeze the address to which 
the write is made, the same address will be applied to 
both the PROMQUEEN RAM chips and the EPROMr and then a 
programming pulse long enough to burn the data coming out 
of the PQ PAM onto the EPROM (50 milliseconds) is 
generated. Care is needed not to feed writes to the 
EPROM too rapidly, or addresses will be missed while the 
PQ remains frozen on the previous address it detected* 

BURN EPROM takes care of this. It also checks the EPROM 
to make sure it is erased before attempting the burn, and 
it VERIFIES that what ended up in the designated range of 
addresses on the EPROM is in fact an exact copy of the 
corresponding address range in PQ RAM. 

We will proceed as though we were going to burn the 
program we wrote while working with EDIT HEX* (It 
doesn't matter if you've obliterated it.) We won't 
remap, but we would need to if we wanted it to work 
directly from an EPROM in the 2 IF SOCKET. 



2-6*1 THE BURN PROCESS - B 

When in EDIT HEX normal mode, you can return to the Menu 
by typing an X or two* Select BURN EPROM by typing a E- 
As soon as you do this, you will see the message BURN 
EPROM, the prompt PROM, and a blinking cursor- You can 
respond with an address in Hex, decimal, or use a MARKER 
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number. Typing an X returns the Main Menu, 
input results in a "past*" noise and no progress. 



Invalid 



GIVE THE ADDRESS ON THE EPROM where you want the burn to 
start* (remember that what should be burned there is the 
PROMQUEEN RAM code address plus $1000.) Since our 
program starts at $6000, we need to answer $7000 to FROM* 
Type in $7000 and <RET0RN>. The prompt, TO, is asking 
the address where you want the burn to end* If we burn 
to S7500, we'll catch everything we wrote up to address 
56500 in PQ RAM* Again, MARKERS, Hex numbers preceded by 
$ f and decimal numbers preceded by # sign will be 
accepted. Abort by typing an X* If you want to change 
where the burn starts, give any invalid entry. sit 
<RET0RH>. if you've given the TO a lower numbered 
address than the FROM, you'll be given the prompt again. 

Before the BORN, Hexkit checks to make sure an erased 

EPROM is in the socket. Since Hexkit is there, the 

screen is probably black, and you are being told to 
"ERASE EPROM." 

************************************************ 

At this time, turn the socket OFF and REMOVE 

the Hexkit EPROM from the ZXF socket. You 

do not want to damage your HSXKIT by mistake* 
******************************* ***************** 

Now, <RETURK>. The go ahead to burn has been allowed/ 
because there is no EPROM in the socket and the socket is 
OFF. In a real situation, at the ERASE EPROM display, 
you can change the EPROM to one that is erased* If you 
do this, the FROM:TO information does not need to be 
reentered. Just turn the socket OFF, change EPROM, and 
turn the socket back ON. As soon as you type <RETURN>, 
Hexkit 1.0 will check the new EPROM to make "sure FF is in 
every location in the range you have told it to burn. 
(You can abort back to the Main Menu by typing an X.) 
When the erasure check is finished, a "clean" EPROM 
causes the SET SWITCH TO BURN display. Set the PROG/BORN 
switch on the PROMQOBEN cartridge to BURN. (The 
MIMIC/PROG switch must be set to PROG and the socket must 
be ON as indicated by the green LED*) 

When you flick the PROG/BORN switch away from you, the 25 
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volt power supply fires up to burn the EPROM f and the 
cartridge starts looking for writes to the address space 
occupied by the EPROM. Nothing will be burned on the 
EPROM until you hit <RET0RN>, but don't <RETORN> before 
you switch to BORN, or you will mias some addresses. 

We don T t suggest that you actually burn an EPROM with the 
message routine we remapped. Therefore , don't switch to 
BORNr just hit <RETURN>. Nothing would happen to the 
EPROM under these circumstances, but you will see the 
BURNING ADDR display, color TV screens will be red, and 
ADDR will continually be updated with the address that 
would have been burned on the EPROM. This will continue 
for as long as it takes to burn the range of addresses 
you specified, and can be up to five minutes for a whole 
2732 or 2732A- This is probably the only Hexkit function 
that takes much time. 

When the burn is finished, you will see the screen change 
again (blue) and you will be prompted to turn the 
PROG/ BURN switch back to PROG. You must do this to 
obtain a valid error check because no data can pass from 
PROMQUEEN to VIC in BURN mode. (If you were to type 
<RETURN> before you set the switch back to PROG, you'd 
see an error indication and the display would freeze 
telling you about an error 
attempted to burn- J If the 
turns green almost instantly; 
screen will remain blue to 
<RETURN> again to see the next 
when you have 
they all are. 



at the first address you 
burn is good, the screen 
If there is an ecror, the 
tell you about it. Hit 
error location. Hit an X 
seen enough errors: if one address is bad, 
The X will return you to the Main Menu. 



Remembers you must give the addresses on the EPROM that 
define the lower and upper limits of the range you want 
to burn. If you give some other address range, but set 
the switch to burn and try to proceed, nothing will 
happen to the contents of the SPROM (unless you have the 
EPROM type switch raisset) . The cartridge must be set to 
burn and Hexkit raust feed it addresses on EPROM for 
anything to actually be recorded. 
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You can use 

program. 



2,6.2 BORNIBG EPROHS FROM BASIC 

a BASIC one-liner in immediate mode as a BURR 



When you set the PROMQUESN BURN Mode (SOCKET ON? 
MIMIC/PROG in "PROG"; EPROM set to EPROM type desired and 
PROG/BURN to the BURN position), the programming power 
supply will come on and the PROMQOEEN RAM will become 
write protected against the VIC (you won't be able to 
read the PROMQOEEN RAM from the VIC either) . Logic on 
the PRQMQUEEN circuit board is set to examine the address 
and block lines coming from tne VIC for any writes to the 
address space occupied by the PROMQOEEN EPROM socket. 
When the cartridge sees a write to an address on EPROM 
(remember this changes when you select a different 
expansion block setting for the cartridge), it duplicates 
the contents of a corresponding location in promqueen ram 
onto the EPROM. The corresponding location in RAH from 
which the byte for burning is fetched is always the 
address on EPROM to which the write is made ainus decimal 
4096 ($1000)* Burning takes about 70 milliseconds per 
byte* so a delay must occur between burning of successive 
bytes- The required BASIC syntax to do this is: 

FOR X=0 TO L-l:POKE A+I f :FORK=*0 TO 65: NEXT J NEXT 

I and K are indexes. L is the number of bytes you want 
to burn. A is the start location on the EPROM in the 
VIC's address space where you want the burn to start. 
You will have to use the actual numbers for A and L to 
enter them into BASIC'S immediate mode* Make sure the 
cartridge is already set into burn mode before you hit 
the return key after typing the one-liner. 



REMEMBER 



This routine won't check erasure before the burn 
cr verify it after. Hexkit's BORN Routine will. 
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2.7 SAVIHG, LOADING, AHD VERIFYING TO DEVICES 



Hexkit 1.0 provides some twists on the usual VIC load r 
save# and verify commands to facilitate handling of 
blocks of machine code. It also supports the disk drive. 

Whenever you type options C, D, or E on the Hexkit Menu* 
your acknowledgement is the routine name. You will 
always be asked for the device number , which can be 1 for 
the cassette, or 8 for the disk. Yog can also type an X 
to abort. You are always prompted for a program name. 
This can be omitted if it is a communication with the 
cassette; a <RETnRN> is sufficient. Keep your names 
under 16 characters and <RETURN> after the name- 



Remember to put a 
initialize it in 



formatted disk in your disk, drive and 

the VIC's immediate mode before you 
attempt disk operations through Hexkit. 

On SAVES, you are always asked FROM and TO. Yog can 

specify what code to save this way. You can do it with 
MARKERS, t decimal, or $ Hex responses. The code will be 
saved under the name you gave it, a reload header will be 
affixed to the file, and if it T s saved to the disk, it 
becomes PRG file. When the SAVE is complete, you'll see 
the Menu, otherwise you see a Kernal error message, such 
as "10 ERROR #5* which means device-not-present. Kernal 
error messages are listed on page 210 of the VIC 
Programmer's Reference. Typing any key brings back the 
Menu. You cannot SAVE out of BLOCK 5, but you can 
relocate load there - we'll get to that. 

BASIC programs can be stored with Hexkit 's SAVE routine 
provided you include in the range of code you save a 
little code program that resets the BASIC pointers 
(locations $2B to $38 on page sero) . SYS the pointer 
resetter routine before you try to run the BASIC after a 
reload. Remap your Hexkit up to high RAM and use the 
SAVE routine to store mixed BASIC and code programs this 
way. You will find it much easier to type in code with 
Hexkit than to enter it through BASIC with DATA 
statements. These mixed language SAVEs reload properly 
with the VIC's own LOAD command; the only trick is to 
start execution by SYSing to the code routine you put 
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there to reset the pointers* Be sure 
language saves from the start of BA3IC* 
vector in address pair ($28-20* 



to save mixed 
(You find this 



After you SAVE, you can verify by typing E on the Menu. 
Rewind your tapes first. You can type an asterisk and 
then <RETURN> "in response to the prompt E3AHE if you are 
verifying a disk save you just made f or omit the name if 
it was a cassette save* You will see the usual Xernal 
messages about device status* You'll see OK if it passes 
and ERROR if it doesn't. The cursor will be blinking at 
the conclusion of the test and you get back to the Menu. 
then, by typing any key* You cannot put an end-of-tape 
marker on tapes through Hexkit* 

The Hexkit LOAD FROH DEVICE runs after you type a D to 
the Main Menu* It will give you the prompt new LOC? You 
can tell Hexkit to put tie code somewhere other than the 
location specified by the header by typing a X. Any 
other key will do to say NO, and X will take you back to 
the Menu. If you say ■yes," you will be asked WHERE?.* 
Marker, SHex, or ^decimal answer are acceptable* Then 
you give the name* The usual Kernal messages will report 
I/O errors* 



If you don't 
not occur. 



say yes to OTIH LOC? r the prompt WHERE does 



The Menu is restored when a 
Otherwise- type any key for 
digested the error message. 



successful load occurs- 
fche Menu after you've 



Most programs don't work after a relocate load: they 
need to be remapped* But you can do such things as use 
Hexkit to shift down code from ROMs in BLOCK S to RAM in 
some space you CAN save from; put the code on some 
device, and later relocate load it to RAM you have put 
into BLOCK 5* 

END OE HEXKIT TUTORIAL 
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3*1 PROMQtTEEN cartridge Dser Controls 

The notes below refer to the drawing on the opposite 

page. 

A) ZERO IHSBMIOH FORCE (ZIF) SOCKET. Release the latch 
handle to install or remove EPROMs, Note that the 
notched end of the EPROM must face away from you. Always 
disconnect the SOCKET by flipping switch (D) away from 
you when removing or installing EPROMs- Connect a 24-pin 
dip jumper cable between here and the target ROM socket 
when using the PROMQOEEN in MIMIC mode. 

B) EPROH TYPE SELECTOR SWITCH. Flip this switch away 
from you to use or mimic 2716 EPROMs. Flip this switch 
towards you to use or mimic 2732A EPROMs. Always make 
sure this switch is properly set before you burn an 
EPROM* Xf this switch is set for the wrong EPROM type 
when you attempt to bucn r that EPROM may be destroyed. 

NEVER USE ANT OTHER TH&H 2716 OR 2732 OR 2732A EPROHS 
WITH THE PHOHQdEBN UHLES3 YOU KHOW WHAT TOO" RE DOING- 

C) BORN/PROG BODE. This switch applies the programming 
voltage to BURN EPROMs. Always leave this switch set to 
PROG (vertical) unless you are using the Hexkit BURN 
routine which WILL TELL YOU WHEN TO FLIP THIS SWITCH TO 
BORN. When the BURN voltage is applied, the RED LED will 
come on, indicating that the DC/DC converter is working. 
You may hear a faint buzzing noise- This is completely 
normal- 

D) ZIF SOCKET CONTROL SWITCH. This switch removes all 
voltages from the ZIF socket when flipped away from you. 
When the green LED goes out <switch off) you can change 
EPROMs or connect the MIMIC cable without having to turn 
off the VIC. This switch must be in the OK position 
(upright) to access EPROMs, BURtt them, or use the MIMIC 
mode. 

E) PROG/KIMIC SWITCH* Leave this switch set to PROG 
(flipped towards you) unless you are using the MIMIC 
mode. The green LED will go out when you flip to MIMIC. 
In the MIMIC mode any programs you have entered to the 
PROMQCEEN RAM are available thru the ZIF SOCKET to an 
external microprocessor, and the PRCMQUEEN RAM is 
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WiBMtKii^ use me PROG/ 8UflNawitcft only to start or terminate a owning run- Change 
WAttWPilj G f ^h^ switch 5«tsm9$<lurin9 abumcoukJ damage the EPROM. 



CIFICU IT BOARD LAYOUT AND USER COhfTROLS POSITIONS 
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disconnected from the VIC. If the EPROM Selector Switch 
is set for 2716, only RAH-1 is accessible. If the EPROM 
Selector Switch is set for 27 32AS, both RAH-1 and RAM- 2 
are accessible to the external computer. 

P) 2716 PEOGRAHMI»G VOLTAGE ADJUSTMENT POT. This is set 

at the factory so that the DC/DC converter makes 25.0 
volts when BDRNing 2716 EPROMS. To measure the 2716 
programming voltage, remove any EPROMS from the 2IF 
socket, set the PROG/MIMIC Switch to PROG r the SOCKET 
switch to ON, the EPROM type selector switch to 2716/ ana" 
last the PROG/BURN switch to BURN. Measure the voltage 
between pin 21 and the ground pin (pin 12) of the socket 
with a VOM of impedance of 10,000 Ohms/V or greater. 

FLIP THE BDRM/PROG SWITCH BACK TO PROG BEPORE YOU OPERATE 
ANY OTHER SWITCHES , AFD WAIT DNTIL THE RED LED GOES OUT. 

G) 27 32/27 3 2 A PROGRAMMING VOLTAGE ADJUSTMENT POT. This 
is set to 25.0 volts at the factory- 21 volts is the 
programming voltage for 2732A EPROMs. You can use the 
PROMQUEEN to program 27 32A's by readjusting the pot to 
provide 21 volts. The procedure is the same as given 
above except that the EPROM type selector switch is set 
to the 2732 position, the voltage is measured between pin 
20 and ground, and you adjust the 2732 pot, not the 2716 

pot* NEVER ATTEMPT TO PROGRAM A 2732A EPROM WITH THIS 
POT SET FOR THE 25V 2732 PROGRAMMING POTENTIAL, 

H) RESET BCTTTON. If you crash the VIC with a faulty 
machine language program in PROMQDEEN RAM, you do KOT 
have to turn the VIC off (which would erase your program 
from the PROMQUEEN RAM) . Just tap the reset button. You 
can restart Hexkit by typing SYS 4112 <RETURN>. 

13 ADDRESS SELECTOR DIP SWITCH. Allows the cartridge to 
occupy any of the 4 expansion blocks of the VIC, DOK'T 



SET MORE THAN 1 BLOCK 

addressing table.) 



AT A TIME, (See page 54 for the 



HOTS: The VIC operates at a clock rate of 2 KHz. To be 
compatible with the VIC r EPROMs must have an access time 
rating no longer than 450 nano seconds. 
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COMMANDS 10 LOAD 
HEXKIT PROGRAM 
INTO VIC RAM 



3.2 PROKQUEEtf ADDRESSING 



LOCATION 

OF 

PROMQUEEN 

RAtf IK 

VIC ADDRESS 

SPACE 



EXPANSION 

BLOCK 

USED 



LOCATION 
OF EPROM 
SOCKET IN 
VIC ADDRESS 
SPACE 



SXS12619 RETURN 
RUN RETURN 



START ADDRESS 
HEX: 2000 
DEC:S192 
LAST ADDRESS 
HEX;2FFF 
DEC;122S7 



START ADDRESS 
HEX:3000 
DEC:12283 
LAST ADDRESS 
HEX;3FFF 
DEC; 16 3 33 



SXS20829 RETURN 
RUN RETURN 



START ADDRESS 
HEX;4000 
DEC =16 3 84 
LAST ADDRESS 
BEX;4FFF 
DEC;20479 



START ADDRESS 
HEX:5000 
DEC;20480 
LAST ADDRESS 
HEXi5FFF 
DEC:24575 



SYS29039 RETURN 
RUN RETURN 



START ADDRESS 
HEX:6000 
DEC;24576 
LAST ADDRESS 
HEX;$FFF 
DEC;28671 



START ADDRESS 
HEX:7000 
DEC:28672 
LAST ADDRESS 
HEX;7FFF 
DEC;32767 



SYS4S44 RETURN 
RUN RETURN 



START ADDRESS 
HEX j AO 00 
DEC;40960 
LAST ADDRESS 
HEXsAFFF 
DECs450S5 



START ADDRESS 
HEX;B000 
DECi45056 
LAST ADDRESS 
HEXsBFFF 
DEC:49151 
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ROTS 1 addition of RAM to BLOCK 1 causes the VIC Kernal 
to relocate the screen memory and BASIC program 
space in the VIC'S RAM. If you have set DIP 
switch #1 on the PROMQUEEN, you will see upon 
start-up that you have 7679 bytes free before 
you load Hexkit. You can see use PROMQUEEN RAM 
for BASIC program storage when not using the 
PROMQOEEN with HEXKIT when the PROMQUEEN is set 
to operate in BLOCK 1. LOADING Hex* it . 
. CADSES SCREEN MEMORY TO BE RESET AS THOUGH TBE 
VIC WERE UNEXPANDED. 

NOTE 2 The Kernal does not allow saving programs to 

devices from out of BLOCK 5* This is to prevent 
users from copying program cartiidges to tape- 
Hence the Hexkit SAVE routine does not work when 
the PROMQUEEN is set to operate in BLOCK 5. 

NOTE 3 Whenever you use the RESET button the VIC will 
check memory to see where it must put the 
screen and program memory. If you use RESET 
with contiguous expansion RAM at 52000 or above 
then HEXKIT will be damaged by the RESET. You 
must load HEXKIT back off its EPROM to run it 
again. 



GENERAL 



NEVER SET WORE THAN 1 OF TflE DIP SWITCHES AT A 
TIKE, T8IS CONFUSES THE VIC, 
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3.3 HEXKIT 1*0 KBTSTBOKE COMMAHDS EST EDIT HKX MODE 
r INITIATE 

is used to start the machine code routine beginning at 
the byte located under the blinking cursor in the 
display. 

J TOMPBACK 

to display the address which had been displayed before 
you used the L, P, or fB keys. * 



K 



CONVERT 



single and two-byte decimal numbers to Hex and enter 
them, 2-byte numbers are entered low-order byte first. 



L LOOK 

at the destination of an offset under 
cursor- Jumpback by typing J to return. 

M ASSTCH A MARKER 



the blinking 



numbered from to F ;Ln Hex to the address at the 
blinking cursor. 



H 



LOAD THB ADDRESS 



at which the designated marker was placed to the location 
of the blinking cursor,, low-order byte first, 

FIHD OFFSETS 

to and from markers, and enter at either end of the jump, 
one end defined by the blinking cursor, the other by the 
Marker. J 

P POSITION 

the display at the location whose low-order byte is 
presently displayed under the blinking cursor. Use J to 
return. 



CCI/tbs 



56 



15 January 1983 



Q SEARCH 

for a specified 16-bit operand. Put the display there* 

R HEMAP 

by adding a specified, offset to the 16-bit operand whose 
low order byte appears under the cursor- ■ 



S STUFF 

a range of bytes from the blinking cursor 
designated stop address with a specified byte. 

T TRANSFER 



up to the 



a block of code starting at a designated address to the 
range of addresses which begin at the blinking cursor and 
end at the designated stop address. 

D OSEft-DEFIMED OPERAHD SEARCH 

put the display on the next byte after detecting a match. 



3.4 THE SEXKIT FTOCTION KETS 

fl C/MODE on/off toggle 

f2 Insert up to stop address 

f3 If in C/MODE, insert a zero stop byte 

f4 Delete up to stop address 

f5 Scroll display to next lower address and bip 

ffi Alternate set Marker keystroke that works in C/MODE 

f7 Scroll display to next higher address and bip 

f8 Reposition display to new address. Jumpback with J 

X Your general purpose abort key 
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CURSOR UP - CURSOR DOWH 



Repeating display scroll 



3,5 BORN ROUTINE SUMMARY 

1. B to the Main Menu 

2. PROM prompt 

Give lowest addcess of your code in PQ RAM + $1000 

3 . TO pr ompt 

Give highest address of your code in PQ RAH + $1000 
<DQ NOT RETURN) 

4. Upper left switch ON 
Green LED on 



5 
6 



8. 

9. 
10. 
11. 

12. 
13 

14 
15 



<R£TURN> 

Erase check 

Black screens turn OFF socket, 
change EPROM r turn ON socket 
<RETURN> again 

Message: SET SWITCH TO BURN 
Upper right hand switch on 

Red LED on 

<RETURN> 

Burn now in progress* Wait. 

(Blue screen). Message: SET SWITCH TO PROG 
Upper right switch OFF 

<RETURN> 

BURN VERIFIED = Good 



ERROR AT nnnn 



Bad 



X to Xeniir or <RETURN> to find the next error 
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4a USIKG MIMIC MODE 

WARNING: MAKE SURE YOU DON'T TURN ON THE EPROM BURNER 
WHEN A MIMIC CABLE IS CONNECTED: YOU COULD DAMAGE YOUR 
EXTERNAL COMPUTER. THE BORNER IS INHIBITED WHEN THE 
PROG/MIMIC SWITCH IS SET TO MIMIC , SO LEAVE THIS SWITCH 
SET TO MIMIC WHEN A MIMIC CABLE IS INSTALLED. 

MIMIC mode is provided so that you can use your VIC's 
keyboard and other program entry means to load programs 
for your own experimental computer devices into the 
PROMQOEEN RAM and access these programs from your own 
separate computer devices as though the PROMQUEEN RAM 
were a programmed EPROM in the EPROM socket in your 
experimental computer device. This capability is 
ordinarily provided only by "microprocessor development 
systems" which are usually many, many times more 
expensive than your PROMQUEEN Cartridge, 

To use the MIMIC capability, first put the program you 
want to try into its proper location in the PROMQUEEN RAM 
Corresponding to the location you want it in a finished 
EPROM} by whatever means you choose- These programs are 
almost always in the machine language of the 
microprocessor in the external computer device. You can 
enter the program using Hexkit, copy it from an existing 
SPROM (either a 2716 oc 2732) you already have and modify 
it as desired using Hexkit; write it (if it is for a 6500 
series processor) using VICMON, load it from tape, disk 
or MODEM or the user port of the VIC— there are raanv ways 
to do it. While loading, the PROMQUEEN must be in the 
normal PROG mode and set for the type of EPROM to be 
mimicked (the green LSD on, the red off). YOUR EXTERNAL 
COMPUTER DEVICE HOST BE EQUIPPED TO USE EITHER 2716 OR 
27 32 SERIES EPROMs IN THE SOCKET YOCJ WILL CONNECT TO THE 
PROMQUEEN, Set the PROMQUEEN EPROM selector switch 
accordingly. 

Turn off the EPROM socket before connecting any cables to 
the PROMQUEEN ZIF socket. Flip the PROG/MIMIC switch to 
MIMIC. You can no longer access the PROMQUEEN from the 
VIC* Leave the VIC on — it is supplying the power to the 
memory in the cartridge. 
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wSSrttw™ m et 1 WJ L tch 0PP and rera0v * any EPRQMs in the 
PROMQUEEN ZIF socket. It's usually advisable to turn the 
external computer device off. The green light on the 
PROMQUEEN should be out. 

Now connect a 24~pin DIP jumper cable to the ZIF socket 
22J£ e PROMQUEEN and latch it down. TO AVOID A POSSIBLE 
SOURCE OF DAMAGE USE A CABLE THAT HAS PIN 24 (VcO 
CLIPPED OFF ON OWE END OF THE CABLE OR THE OTHER. THI C 
WILL PREVENT YOUR EXTERNAL COMPUTER DEVICE PROM POWERING 
ISL? C/DC C0NVEB ^R IF YOG SHOULD ACCIDENTALLY FLIP THE 
PROG/BURN SWITCH TO BURN. ALSO, NEVER LEAVE THE JUMPER 

£^£ TED DURXNG USE 0F ANY 0THE * "HAN MIMIC MODE. IF 
«2L^25? ° N THE BUM M0DE WW^ SO PPL Y WITH THE CABLE 
CONNECTED, YOUR EXTERNAL COMPUTER COULD BE DAMAGED, Make 
sure you have no twists in the cable (i.e., that pin 1 of 
the ZIP socket connects to pin 1 of the target EPROM 
socket in the external computer device), and plug the 
other end of the cable into the target EPROM socket. 
Avoid cables over 3 feet long— they are more likely to 
pick up noise. (Ideally, the MIMIC cable is shielded. 
If you are using an unshielded cable and a routine that 
should work doesn't, try wrapping the cable with aluminum 
foil.) 

Turn the FRGMQUEEN SOCKET switch ON (the green light will 
stay outJ to try your program on the external computer 
device, if it works— flip the SOCKET switch off, remove 

t Jr?i? le \. insfc311 an erased EPROM, flip the PROG/MIMIC 
to PROG, the SOCKET switch back on, and burn the program 
onto a compatible EPROM in the usual way. That SPROM 
will work in the target EPROM socket. 



on 



the 

YOU 



*L5) e u ayr y0a don<t n « ed to burn any more bytes _ 
eproh than those occupied by your debugged routine, 
can build your programs onto the EPROM step by step. 

The PROMQDEEN is made to MIMIC for 6502 tvpe 
microprocessors which do not separately decode th* 
EPROM's CS and OE signals. These 2 pins are shorted 
together inside the PROMQUEEN. Some 8090, 3085, z-ao, 
etc. systems do separately decode these signals. If so, 
you must clip off the OE pin on your jumper cable in 
order to prevent bus conflict which would cause the 
external computer to crash. Also some Atari ROK cards 
and the like short OE directly to ground. Clip off the 

Se P PROMQOEof. ° able t0 ^^ MIWIC W ° rk properl y through 
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4.2 EEKAfPIHG HEXKIT WITH VICMQN 

VICMON has a very handy remapping function (keystroke N) 
which ^ is a worthwhile addition to the search and remap 
functions in Hexkit. If you have VICMON, use it to 
disassemble Hexkit. You will find that it is organized 
so that the program itself occupies one continuous block 
of memory (from 51010 to S1B7C) . You will see that the 
prompts table is one contiguous block from S1B7B to 
SID29? S1D2A - 5ID77 is the message start address list* 
then another contiguous block from 51D78 to $1DC3 
contains three consecutive jump tablesi one for the Main 
Menu, one for the normal mode EDIT HEX keystroke 
commands, and one for the C/MODE EDIT HEX keystroke 
commands. Last comes a cursor position table, a table 
for decimal conversions , then the 0* search mode table, 
and space devoted to names you assign when storing 
programs with devices. This organization facilitates 
remapping. One needs only use the VICMON N function 
twice, once with the m W n an the jump tables, and once 
without the w on the program body to make- it work where 
you want it. in fact, moat 6502 code is organized this 
way. You will, for instance, find VICMON 1 s jump tables 
starting at its base address + $E80 and ending at its 
base address + $£B4 if you apply VICMON to itself. 

We encourage you to remap Hexkit to where you want it. 
Use Commodore's VICMON program as follows j 



1) 



Transfer the code with VICMON by starting VICMON 

with the usual SYS command. Then, enable the 

alternate page zero at a safe location, and qive 

VICMON the command; * 



T 1000 1DFE AAAA <RET0RN> 

where aaaa is the start address in Hex of where 
you want the Hexkit program to run. You can onlv 
move Hexkit by some multiple of 256 bytes. If the 
move is noi some multiple of 256 bytes, the 
program will not work. 
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2) Remap the code part of Hexkit with -the VICMQN 
command: 

.K AAAA BBBB 0000 1010 1DFF <RET0RN> 
Wbere BBBB = AAAA 4 B69. 

3> Remap the jump tables part of Bexkit with the 
VICMON commands 

•N CCCC DDDD 0000 1010 1DFP W <RETURN> 

Where CCCC = AAAA + $D1A, and DDDD - AAAA +■ $DAC. 

4) Change the setup pointer for the NAME Kernal 
subroutine. Qse Hexkit's own Q Search to find the 
call to 5FFBD, the call to SETNAM and edit the 
preload of X and Y as required. This should point 
to the $DE0th byte of Hexkit where you have put 
it. 

5! Run the Hexkit at its new location by typing SYS 
(decimal equivalent of AAAA) . 

************************************** ******* 



REMEMBER: 



THE PROSQUEEN RAM AND EPROM OCCOTY DIFFERENT 

LOCATIONS IBT THE VIC 



The PROMQUEEN CARTRIDGE occupies a total Of 8 kilobytes of 
address space (8192 bytes). The first 4 kilobytes (4096 
addresses) are allocated to PROMQUEEN RAM, The second 4 
kilobytes are allocated to EPROMs. You can easily place the 
cartridge into any of the 4 VIC expansion blacks, 

AS FAS AS THE VIC IS CONCERNED, THE PROMQUEEN RAM AHD THE 
PROMQUEEN EPROM SOCKET NEVER OCCUPY THE SAME ADDRESS SPACE. 

This means that if you simply burn a machine language 
program onto EPROM after developing it and debugging it in 
PROMQDEEN RAM it will not wock directly from the EPROM when 
you attempt to run it from the VIC if any of the following 
statements are true: 



1) Your program calls subroutines 
PROMQUEEN RAM address space. 



inside the 
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2) Your program jumps to addresses within the 
RRQMOUEEK RAM address space. 

3> ¥qux program executes indirect jumps to locations 
within the PRCMQOBEN RAM address space* 

You must remap any such statements by adding decimal 40 96 
($1000) to their operands before you burn the program on 
ERROM if you want the program to work directly off the 
ERROM. Record the addresses where such statements occur 
to make things easy* Alternatively, if you have VICHON 
be sure to use the *N n routine before you make your burn- 
No remapping is necessary for burning ERROMs with 
programs developed for and tested on external computers 

with the MIMIC mode. 

********************************************* 
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4.3 P&EVBOTI8G CRASHES WBEH RUNNING VICHOH AND HEXKIT 

TOGETHER 

Hexjcit and VICMOH are not quite compatible because of the 
need for both to operate without damaging BASIC programs. 
You must use the ?ROMQUEBN reset button to stop VICMOH if 
you don't want to leave the seeds of a crash, but this 
unfortunately clears any BASIC pointer settings if you 
are also running a BASIC program. 

The alternate crash prevention routine below works 
without damaging the BASIC pointers. It is a routine 
that resets the BRK pointer at location $316 - $317 to 
its default value of ?FSD2. Just enter this program 
somewhere and run it after you have exited VICMOR with 
its X command. The routine can be put anywhere without 
remapping r and is called by the BASIC command SXS 
(decimal address of the routine) . The routine is as 
follows: 



SEI 




7fl 




LDA 


#$D2 


A9 


D2 


STA 


#0316 


8D 


1G 


LDA 


#?FE 


AS 


PE 


STA 


$0317 


80 


17 


CLI 




58 




RTS 


=13 bytes 


60 





03 



03 



Don't tun Hexkit until you have run the above routine 
first. 
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4.4 THE HEX3UT 1-0 HEADER 

HexKit 1*0 comes with a 512 byte header written in 
machine code. This header permits you to load and run 
Hexkit 1.0 off its . EPROM from any of the four VIC 
expansion blocks. It also lets you make auto start/auto 
run/auto load — from anywhere—EPROMS out of BASIC 
programs. If you need to do this in nonstandard 
situations* the following information will help you. It 
may be easier to understand if you follow along with your 
PROMQUEEN set up to operate. Set B&0CK 5 and load Hexkit 
with SYS 45441, Leave the Hexkit EPROM in and on. 
Select EDIT HEX and give the address 56000 for the 
display. Scroll from SB00O up to see the following: 

1) In $B0oo-SB001 is a vector to the start of the 
user -specif ied machine code to handle auto starts. 
$B0G2~$B003 contain a vector to the SCNKEY Kernal 
routine. This prevents crashing when you type 
<RESTORE> . 

23 In §B004-?B008 is the sequence of bytes the VIC 
looks for at address SA004-5A008 during start-up 
to see if an auto start is requested* 

31 In SBQ0A-$B023 is the code that handles auto 
starts if it is found at SAO0A~?AG28. It does the 
following: 

a) calls the same four Kernal setup routines 
the VIC usually calls on power up 

b) calls a routine that disables the STOP key 

c) does a little setup and loads the command 
SYS 41336 <RETUHH> into the VIC'S keyboard 
buffer 

d) jumps to the normal BASIC start-up entry. 

When the BASIC wakes up and finds that SYS command in the 
keyboard buffer, it executes it just the same as if you 
had typed it. The SYS command is the same one you 
manually type to load and run an EPROMed BASIC program in 
address block 5A0O0. This particular SYS command calls 
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the reload to unexpanded VIC's 
handle expansions. 



It must be changed to 



4) Prom $B02A~$B02F is the kill-STOP-key routine 
called during resets and auto starts, 

5) Prom ?B030-$ : B03F is the keyboard buffer loader 
routine. This routine uses a vector which has 
been previously loaded on the VIC's zero page in 
locations $01~$02 to access a table of character 
strings to load in the keyboard buffer. The table 
of character strings begins at SB040 and extends 
to 5B04F. Only part of the table space is used. 
Special addressing techniques are used to allow 
this routine with its table to work in the 
different locations it must. It will work 
anywhere you want it to provided you first point 
to its start address in locations $01-$Q2* and 
load the Y register with the index which roust be 
added to the start address of the routine to 
specify which character string to put in the 
keyboard buffer. Dse Bexkit's C/MODE to type in 
the string just as you would from the keyboard and 
indicate end of string by using the F3 key. It 
will figure the number of characters for you r but 
don't put more than 10 character commands in the 
keyboard buffer at one time. 

6) Prom $B050-SB080 is a machine code shift routine* 
it shifts from bottom up only. This routine is 
fully relocatable, and if used by itselff requires 
the following setup: 



a) 



Put the origin of the shift in locations 
SFB-SFC on the VIC's page zero (low order 
byte first) 



b) 



Put the destination of the 3hift 
locations $FD-$FE 



in 



c) Put the number of bytes to be shifted in 
S0334-5033S 

d) Call the routine. 
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7) From $B085 to $B005 is a routine which first 
clears the screen and then proceeds to manage the 
transfers necessary to load BASIC programs from 
EpROMs. This is done to enable the same routine to 
work regardless of its location. The routine 
pull3 the return address of the location from 
where it was called to find out its origin. Prora 
this it calculates the location of the data 
specifying the setup for the shift routine and 
what address to use to call the shift and keyboard 
buffer loader routines. You are giving the 
information this routine needs to figure out where 
it is when you type the particular SYS command to 
load a BASIC program from a particular socket- 
Once the routine knows where it is, it first looks 
up from a table pointed at by the pulled return 
address to do the setup and shift of the BASIC 
program from EPROM to VIC HAM, The BASIC pointers 
are also set on the VIC's page zero as required to 
make the BASIC work- (These are automatically 
stared by SYS 45312.) 

$) At SBODO to SBOFC is the routine that puts the 
VIC's screen back where it is in an unexpanded 
VIC, It is called automatically when you use the 
SYS commands to load to an unexpanded VIC* (This 
lets Bexkit load properly into expanded VICs.) 

9) At SB111-SB119 is the routine you call as SYS 
45312 to save BASIC on EPROMs. It does all setup 
required to prepare the PROMQBEEN RAM with the 
image of the EPROM to be burned- It does so by 
doing three shifts, First, it copies the Bexkit 
header to PROMQUEEN RAH. It then saves the BASIC 
pointers. Last, it copies the first 3583 bytes 
from the start of BASIC to the PRCMQUEEN RAM 
starting at SA20X* You don't need to do anything 
special if the VIC is expanded. 

10) Then come a series of tables holding setup data. 
These will be explained in more detail because you 
may want to doctor them under certain 
circumstances. 

11) After some open apace, you come to 5B1P0 where the 
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list of BASIC pointers is stored* 



4,5 DOCTORIHG THE AUTO SAVE HEADER FOR HONSTAHDARD 

RELOADS ; 

You never have to modify the automatic save routine (SYS 
45312) regardless where the BASIC is located and 
irrespective of the length of the program you want to 
burn on the EPROM, You do* however, have to modify the 
reload tables if. 

1) Your program is expected to run in a 3K expander. 

2) Your program is longer than 3583 bytes and hence 
will require a second EPROM to hold it all* 

The reload program derives control information from a 
number of tables that tell it 

1) the length of the program. 

2) where the program is to be loaded to* 

The reload program finds the data applicable for the 
situation by determining from where it was called. 

There are 16 reload entry points which allow reloads from 
the 9 possible addresses into which you can plug EPROMs. 
Eight of these entry points are for loading to the 
unexpanded VIC* and because they are used to load Hexicit 
into VICs which may be expanded, they all first call the 
routine to RESET the screen to S1EO0 so that you don't 
have to worry about where the VIC screen is when you want 
to load Hexkit. 

Eight more reload entry points allow the reload to occur 
without change of screen memory location occur ing first. 
These reload entries are for loading to 8K or more RAM 
expanded VICs. 

The table on the following page tells you the SYS 
command to use to access the reload header properly from 
wherever you choose to plug in an EPROM. It also tells 
you where that particular entry point will be found in 
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the PRQMQOEEN RAM after you have used SYS 45312 to do 
the set up for you. 

Let us assume that we have an 4095 byte long program that 
we want to auto start in an 8K RAM expanded VIC* Here is 
how to proceeds 

1) Load and run the program with the FROMQUEEN in 
BLOCK 5. 

2) Stop it and use the AUTO SAVE (SYS 453 12) from 
your Hexkit EPROM. 

3) Look up on the table on page 72 to find where the 
reload entry for reload to an expanded VIC from 
BLOCK 5.0 appears in PRCMQUEEK RAH after use of 
SYS 45312. You will find the applicable address 
is SA1A8. 

4) Load Hexkit off its EPROM with SYS 45441 * Select 
EDIT BEX and go to SA1A8. You will see the entry 
starts with a 6502 JSR A095 command* Scroll down 
to SA1AB where you will find the low order then 
the high order byte of the program length. Change 
these to the new program length + l f which in Hex 
is S1000. Remember — low order byte first. 

5) The third byte in the table is correct already 
unless you had wanted the program to load to a 3K 
expander. If this is the case, change the 12 to a 
04. 

6) Make sure the auto start SYS command goes to this 
routine* you will find this character string in 
5A040 to SA048. Use the Hexkit C/MODE to change 
this from its present 41336 to 41384. This will 
cause the auto start to access the entry you just 
doctored* 

7) Burn a 4K EPROM with the present contents of 
PROMQUEEN RAM. (Burn from $B000 to SBFFF) . 

3) Reload the BASIC program r run it, then stop it. 
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9) in Immediate Mode POKE the balance of the program 
into PROMQUEEN RAH* In our example situation we 
already EPROMed the first 3583 bytes, so we need 
only to do the rest* This is 

4095 
-3583 



1512 

The command to do this is 

PORI»0 to 1511: POKE 40960+I r PEEK (8192+1) 
NEXT 



Be prepared 
Hexkit* 



to wait: BASIC is much slower than 



10) Load Hexkit. Put 
SBO0O up to the 
PROMQOEEN RAM* 



in a £resh EPROM and BURN from 
end of the program segment in 



11) Use the first EPROH in an expansion socket at 
5A000 and put the second one in what we call BLOCK 
5.5 which is a socket at SBO0O. 

Take some time to study carefully how the reload header 
works and you will find that you can handle almost any 
situation* 
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BY WAY OF REVIEW: 

To set up program in VIC for burning on EEROM 

A. Install PROMQUEEN in BLOCK 5. 

B. Install expansion memory if used. 

C. Turn on the VIC and load the program to be 
EBROHed. 

D. With Hexkit ERROM in PROMQUEEN zip -socket enabled 
type 

SYS 45312 <RETORN> 

E. Load Bexkit into VIC with: SYS 45441 <RETt-RN> 

F. Doctor reload header: tables as required if: 

1) The program is longer than 3583 bytes and/or 

2) The program is to be reloaded to a VIC with a 
3K memory expander (BASIC to start at $0400). 

G. Burn a fresh ERROM with present contents of 
RROMQUEER RAM. Burn must be at least decimal 512 
t (length of program) bytes long. 

H. If program longer than 3583 bytes, reload it in 
VIC and poke the rest of it into PROMQOEEM RAM 
starting at 40960. 

I. Burn the second ERROM using Hexkit. Install it in 
VIC address apace immediately above first ERROM. 

The order of reload table data is; <low byte of program 
length), (high byte of program length), (high byte of 

start of BASIC) . 
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4,6 AEJOCIT 1.0 AOTO BASIC RELOAD HEADER CALLS 

EPROM TO VIC 





(1) 


(2) 






UNEXPANDED LOC. OF 


EXPANDED 


LOC. OF 


BLOCK 


VIC TABLE 


VIC 


TABLE 


1.0 


SYS8514 SA142 






1.5 


SYS12619 5A14B 


SYS12S82 


5A18A 


2.0 


SYS16724 SA154 


SYS16784 


SA190 


2.5 


SYS20329 SA1SD 


SYS20886 


5A196 


3.0 


SYS24934 $A166 


SYS24988 


5A19C 


3.5 


SYS29039 SA16F 


SYS29G90 


SAIA2 


5.0 


SYSS41336 SA178 


SYS41384 


5A1A8 


5.5 


SYS45441 SiUel 


SYS45486 


$A1AE 




1) These calls all first 


call a routine 


that resets 



VIC screen to 51EO0. 



2) Use these calls if 8K or larger RAM expanded Vic. 
(Doctor the start of BASIC byte If you must load 
to a 3K expander.) 
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5.1 PROMQUEEN CARTRIDGE EPROH COMPATIBILITY 

The PROMQUEEN CARTRIDGE is shipped set for proper 
operation with 2716 EPROMS when its selector switch is 
set for 2716b, and foe proper operation with 2732s with 
the selector switch set for 27 32s. 

The programming voltage for 2716s is 25 volts. *be 
programming voltage for 2732s is also 25 volts. There 
are separate potentiometers accessible through the small 
holes in the left side of the cartridge for adjusting 
these voltages, 2732A EPROMs require 21 volts for 
programming* You can reset one of the pots to get the 21 
volts required for 2732AS when the selector switch is set 
for 2732AS. See page 51. You can always read a 2732 
with the programming voltage set to 21 volts for 2732As. 
DGS'T TOY TO PROGRAM A 27 32 A WHEN TOU HAVE TBS VOLTAGE 
SET TO 2 5 VOLTS FOR 27 32s. YOU WILL DAMAGE THE 27 32A. 

irrespective of EPROM type r the EPROMs you use must be 
rated for access time of 450 nano-seconds or faster. The 
2 megahertz clock of the VIC does not allow sufficient 
time to read EPROMs which require more than 450 
nano-seconds to access. Some 450 nano-second SPROMs are 
marginal- Use 390 nano-second EPROMs to be safe it you 
can* Unless you know how to make the proper adaptions 
NEVER USE ANY OTBER THAN THE 2716, 2732 , OR 27 32A EPROMs 
ON YOUR PROWQUEEN. To aid those who want to program 
2532's or 2764 's with a PROKQUEEN, data sheets for these 
EPROMs are included on the following pages. You can hot 
wire for them <but be careful) . 

2716 EPROMs contain 2 kilobytes of address space per chip 
(that is 2048 bytes exactly! . Each address is uniquely 
defined by its own combination of l's and r s on the 
eleven address selector lines coming from the chip. 
Addresses start at binary 00000000000 (eleven zeros) and 
end at binary 11111111111 (eleven ones). 

2732 EPROMs contain 4 kilobytes of address space per chip 
(that is 4096 bytes exactly) . Bach address is uniquely 
defined by its own combination of l's and O's on the 
twelve address selector lines coming from the chip- 
Addresses start at 000000000000 (12 zeros) and end at 
111111111111 (twelve ones). 



I 
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Conflict between memory devices which could be triggered 
by identical combinations of l's and O's is avoided 
because each chip requires a signal on an additional pin, 
called "chip select" in order for it to respond to an 
address on its address pins. There is a separate chip 
select line for every memory chip in the VIC. When you 
change the block setting on the BLOCK selector DIP switch 
in the PROMQUEEN CARTRIDGE, you are changing which of the 
VlC's expansion "chip select" lines is connected to the 
cartridge. 

EPROMs contain the number 25 5 in decimal <FF in hex or 
11111111 in binary) in each address as they are shipped 
from the factory or erased. An ultraviolet lamp is used 
to erase EPROMs. Such a lamp is available from Logical 
Devices Inc., among others. The Logical Devices Eraser 
is the most economical we know of. It costs $49,95, 
Call Fort Lauderdale* Florida information, then the 
company to order one. . This particular lamp takes 15 
minutes to erase an EBROM. your PROMQUEEN dealer may 
carry it. He may also cary EPROMs and jumper cables. 
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L 



5.2 PROHGOEBH ELECTRICAL 3UHHARY 



1) The address lines enter the cartridge thcough 
latching tri-state buffers. These buffers usually 
run unlatched, unless a low signal is applied to 
the latch pins. The output of a one- shot 
multivibrator is connected to the latch pins of 
the address buffers. 






2) This one-shot multivibrator is logically connected 
so that it triggers when the following are true 
simultaneously ; 

a) The VIC microprocessor read/write line goes 

low* indicating a write- 
to) The block select line goes low, indicating 

that the VIC microprocessor is selecting 

the cartridge* 

c) Address line All goes high r indicating that 
the EPROM is selected* 

d) Triggering is enabled by the setting of the 
PROS/BORN switch to BURN. 

3) When the one-shot triggers r the EPROM address to 
which the write was attempted is frozen on the 
cartridge by the latching of the address buffers; 
address lines AO to A10 are decoded both to the 

EPROM and to the PROMQUESN RAM Chip3 (2-6116 r s). 

The chip enable line to the 6116 selected by RIO 
is brought low, causing the data in the selected 
RAM chip to be output onto the EROMQ0EEN ' s 
internal .data bus* The VIC's da.ta bus was 
disconnected from the PROMQUEBK's data bus when 
the cartridge was set to PROG/ thus the data 
written by the VIC never gets to the EPROM. 
Instead , the data from that single selected RAM 
address is applied to the EPROM data pins through 
a buffer. Since the address is held 3table by the 
latches , the data stays stable t too. Meanwhile 
the same set of signals on address lines AD-All is 
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being applied through buffers to the EPROM 's 
address pins. The programming voltage is also 
being applied? this started when FROG/BORN was set 
to SORK. 



4) A few microseconds after the one-shot triggers , 
its output causes a second one- shot multivibrator 
to trigger. This second one-shot is timed to 
remain triggered for 50 milliseconds to generate 
the programming pulse to the EPROM. The 



programming pulse 
enable pin. 



is applied to the EPROM 's chip 



5) After the conclusion of the programming pulse, the 
first one-shot untriggers which once again 
unlatches the address buffers. The cartridge can 
now look for a new attempted burn to a location on 
EPROM. 



remember it takes about 70 milliseconds to burn a single 
EPROM location* This .is why you need to generate a time 
delay between each burn signal to the prcmqoses 
cartridge* 



Note the following, 

electronics; 



if you are interested in the 



a) That both the data lines and the address 
lines connected between the EPROM socket 
and the PROMQUEEN RAM pass through 
tri-state bus transceivers (74LS245's). 
You are putting these buffers into high 
impedance and turning off both Vcc and Vpp 
to the EPROM when you turn the SOCKET 
ON/OFF switch to off. 

b) That the VlC's data lines pass through a 
buffer (another 74LS245) before connecting 
to the PROMQDEEN RAM chips. This buffer is 
bidirectionalf with its direction under 
control of the VIC'S R/w line. It is also 
tri-sta table, and remains at high impedance 
unless the PROMQUEEN cartridge address 
space is selected by the VIC's BLOCK 
signal. Additional logic provides that 
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this buffer remains in the high impedance 
condition if the cartridge is set to BURN 
mode, or if the MIMIC mode is selected. 

c) That the address latches buffering the 
VIC'S address bus into the PROMQUEEN 
CARTRIDGE are tri-statahle. You are 
placing these buffers into high impedance 
when you select MIMIC mode* 

d) That the buffers on the address lines to 
the EPROM socket are bidirectional. You 
are setting them so that address 
information is passed from promqueEN RAM to 
the EPROM socket when in PROG or BORN mode. 
^hen you set the MIMIC mode, these buffers 
turn around to pass address codes received 
from jumper cables in the EPROM socket 
through to the PROMQUEEN RAH- 

e) That the data buffer between the PROMQU6EN 
RAM and the EPROM socket , being 
bidirectional , is set to' pass information 
out from PROMQUEEN RAM to the EPROM socket 
when in BURN or MIMIC mode. This buffer 
passes data from the EPROM socket on 
through to the VIC only when the cartridge 
is set to PROG mod$. 
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